AWS AppSync Noneデータソースのリゾルバーマッピングテンプレートリファレンス - AWS AppSync
リクエストマッピングテンプレートVersionペイロードレスポンスマッピングテンプレート

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS AppSync Noneデータソースのリゾルバーマッピングテンプレートリファレンス

注記

現在、主に APPSYNC_JS ランタイムとそのドキュメントをサポートしています。APPSYNC_JS ランタイムとそのガイドの使用を検討してくださいhttps://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-js-version.html。

None タイプのデータソースで使用される AWS AppSync リゾルバーマッピングテンプレートを使用すると、 AWS 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 フィールドは必須です。

例:

"version": "2018-05-29"

ペイロード

payload フィールドは、任意のウェルフォームをレスポンスマッピングテンプレートJSONに渡すために使用できるコンテナです。

payload フィールドはオプションです。

レスポンスマッピングテンプレート

データソースがないため、 payload フィールドの値はレスポンスマッピングテンプレートに転送され、 VTL$context.resultプロパティを介して使用可能なcontextオブジェクトに設定されます。

payload フィールド値の形状と GraphQL タイプの形状が正確に一致する場合、以下のレスポンスマッピングテンプレートを使用して、レスポンスを転送できます。

$util.toJson($context.result)

レスポンスマッピングテンプレートに適用される形状の制限や必須フィールドはありません。ただし、GraphQL が厳密に型指定されているので、解決されたマッピングテンプレートは予想される GraphQL タイプに一致する必要があります。