None 数据源的解析器映射模板参考 - Amazon AppSync
请求映射模板版本有效负载响应映射模板
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

None 数据源的解析器映射模板参考

注意

我们现在主要支持 APPSYNC_JS 运行时环境及其文档。请考虑使用 APPSYNC_JS 运行时环境和此处的指南。

通过使用与 None 类型的数据源一起使用的 Amazon AppSync 解析器映射模板，您可以设置 Amazon AppSync 本地操作的请求形状。

请求映射模板

映射模板很简单，使您能够通过 payload 字段传递尽可能多的上下文信息。

{
   "version": string,
   "payload": any type
}

下面是请求映射模板的 JSON 架构表示形式（解析后）：

{
    "definitions": {},
    "$schema": "https://json-schema.org/draft-06/schema#",
    "$id": "https://aws.amazon.com/appsync/request-mapping-template.json",
    "type": "object",
    "properties": {
        "version": {
            "$id": "/properties/version",
            "type": "string",
            "enum": [
                "2018-05-29"
            ],
            "title": "The Mapping template version.",
            "default": "2018-05-29"
        },
        "payload": {}
    },
    "required": [
        "version"
    ],
    "additionalProperties": false
}

以下是通过 VTL 上下文属性 $context.arguments 传递字段参数的示例：

{
    "version": "2018-05-29",
    "payload": $util.toJson($context.arguments)
}

payload 字段的值将转发到响应映射模板并可用于 VTL 上下文属性 ($context.result) 上。

这是一个表示 payload 字段的内插值的示例：

{
    "id": "postId1"
}

版本

version 字段是所有请求映射模板通用的，用于定义模板使用的版本。

version 字段为必填项。

示例：

"version": "2018-05-29"

有效负载

payload 字段是一个容器，可用于将任何格式正确的 JSON 传递到响应映射模板。

payload 字段为可选项。

响应映射模板

由于不存在任何数据源，payload 字段的值将转发到响应映射模板并在 context 对象上设置（此对象可通过 VTL $context.result 属性提供）。

如果 payload 字段值的形状与 GraphQL 类型的形状完全相符，您可以使用以下响应映射模板转发响应：

$util.toJson($context.result)

没有必填字段，也没有形状限制应用于响应映射模板。但是，由于 GraphQL 是强类型化的，因此解析的映射模板必须与预期的 GraphQL 类型匹配。