本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
HTTP 解析程序映射模板参考
这些区域有:AmazonAppSync HTTP 解析器映射模板使您能够从Amazon以及从 HTTP 终端节点返回的响应的 AppSyncAmazonAppSync。通过使用映射模板,您还可以向Amazon关于要调用的操作的性质的 AppSync。本节介绍用于支持的 HTTP 解析程序的不同映射模板。
请求映射模板
{ "version": "2018-05-29", "method": "PUT|POST|GET|DELETE|PATCH", "params": { "query": Map, "headers": Map, "body": string }, "resourcePath": string }
解析 HTTP 请求映射模板后,请求映射模板的 JSON 架构表现形式如下所示:
{ "$id": "https://aws.amazon.com/appsync/request-mapping-template.json", "type": "object", "properties": { "version": { "$id": "/properties/version", "type": "string", "title": "The Version Schema ", "default": "", "examples": [ "2018-05-29" ], "enum": [ "2018-05-29" ] }, "method": { "$id": "/properties/method", "type": "string", "title": "The Method Schema ", "default": "", "examples": [ "PUT|POST|GET|DELETE|PATCH" ], "enum": [ "PUT", "PATCH", "POST", "DELETE", "GET" ] }, "params": { "$id": "/properties/params", "type": "object", "properties": { "query": { "$id": "/properties/params/properties/query", "type": "object" }, "headers": { "$id": "/properties/params/properties/headers", "type": "object" }, "body": { "$id": "/properties/params/properties/body", "type": "string", "title": "The Body Schema ", "default": "", "examples": [ "" ] } } }, "resourcePath": { "$id": "/properties/resourcePath", "type": "string", "title": "The Resourcepath Schema ", "default": "", "examples": [ "" ] } }, "required": [ "version", "method", "resourcePath" ] }
以下是 HTTP POST 请求的示例,具有 text/plain
正文:
{ "version": "2018-05-29", "method": "POST", "params": { "headers":{ "Content-Type":"text/plain" }, "body":"this is an example of text body" }, "resourcePath": "/" }
版本
仅限请求映射模板
定义模板使用的版本。version
对于所有请求映射模板都相同且是必需的。
"version": "2018-05-29"
方法
仅限请求映射模板
以下 HTTP 方法或动词(GET、POST、PUT、PATCH 或 DELETE)AmazonAppSync 发送到 HTTP 终端节点。
"method": "PUT"
ResourcePath
仅限请求映射模板
您要访问的资源路径。资源路径与 HTTP 数据源中更多终端节点一起,构成AmazonAppSync 服务向发出请求。
"resourcePath": "/v1/users"
评估映射模板时,此路径作为 HTTP 请求的一部分发送,包括 HTTP 终端节点。例如,上一个示例可能会转换为如下所示:
PUT <endpoint>/v1/users
参数字段
仅限请求映射模板
用于指定搜索执行的操作,最常用的方式是设置询问在身体. 但是,可以配置若干其他功能,如响应的格式设置。
- headers
-
标头信息(为键值对)。键和值都必须是字符串。
例如:
"headers" : { "Content-Type" : "application/json" }
目前支持的
Content-Type
标头包括:text/* application/xml application/json application/soap+xml application/x-amz-json-1.0 application/x-amz-json-1.1 application/vnd.api+json application/x-ndjson
注意:您不能设置以下 HTTP 标头:
HOST CONNECTION USER-AGENT EXPECTATION TRANSFER_ENCODING CONTENT_LENGTH
- query
-
指定常用选项的键值对,如 JSON 响应的代码格式设置。键和值都必须是字符串。以下示例显示如何发送
?type=json
格式的请求字符串:"query" : { "type" : "json" }
- body
-
正文包含您选择要设置的 HTTP 请求正文。请求正文始终是 UTF-8 编码格式的字符串,除非内容类型指定字符集。
"body":"body string"