AWS ドキュメント » Amazon API Gateway » 開発者ガイド » Amazon API Gateway での REST API の作成、デプロイ、および呼び出し » Amazon API Gateway で REST API を作成する » API Gateway リクエストおよびレスポンスデータマッピングを設定する » Amazon API Gateway API リクエストおよびレスポンスデータマッピングリファレンス » 統合パススルーの動作

統合パススルーの動作

非プロキシ統合の場合は、メソッドリクエストにペイロードが含まれ、Content-Type ヘッダーが、指定されたマッピングテンプレートに一致しないか、マッピングテンプレートが定義されていない場合は、クライアントで提供されたリクエストペイロードを、統合リクエストを通じて変換せずにバックエンドに渡す選択ができます。このプロセスは統合パススルーと呼ばれます。

プロキシ統合の場合は、API Gateway がリクエスト全体をバックエンドに渡します。パススルー動作を変更するオプションはありません。

入力リクエストの実際のパススルー動作は、統合リクエストの設定中に、指定されたマッピングテンプレートに選択したオプションと、クライアントが受信リクエストで設定する Content Type ヘッダーによって決まります。次の例では、可能なパススルー動作について示します。

例 1: application/json コンテンツタイプで 1 つのマッピングテンプレートが統合リクエストで定義されている。

Content-Type ヘッダー\選択されたパススルーオプション	WHEN_NO_MATCH	WHEN_NO_TEMPLATE	NEVER
なし (デフォルト: application/json	リクエストペイロードはテンプレートを使用して変換されます。	リクエストペイロードはテンプレートを使用して変換されます。	リクエストペイロードはテンプレートを使用して変換されます。
application/json	リクエストペイロードはテンプレートを使用して変換されます。	リクエストペイロードはテンプレートを使用して変換されます。	リクエストペイロードはテンプレートを使用して変換されます。
application/xml	リクエストペイロードは変換されず、そのままバックエンドに送信されます。	リクエストは、HTTP 415 Unsupported Media Type レスポンスで拒否されます。	リクエストは、HTTP 415 Unsupported Media Type レスポンスで拒否されます。

例 2: application/xml コンテンツタイプで 1 つのマッピングテンプレートが統合リクエストで定義されている。

Content-Type ヘッダー\選択されたパススルーオプション	WHEN_NO_MATCH	WHEN_NO_TEMPLATE	NEVER
なし (デフォルト: application/json	リクエストペイロードは変換されず、そのままバックエンドに送信されます。	リクエストは、HTTP 415 Unsupported Media Type レスポンスで拒否されます。	リクエストは、HTTP 415 Unsupported Media Type レスポンスで拒否されます。
application/json	リクエストペイロードは変換されず、そのままバックエンドに送信されます。	リクエストは、HTTP 415 Unsupported Media Type レスポンスで拒否されます。	リクエストは、HTTP 415 Unsupported Media Type レスポンスで拒否されます。
application/xml	リクエストペイロードはテンプレートを使用して変換されます。	リクエストペイロードはテンプレートを使用して変換されます。	リクエストペイロードはテンプレートを使用して変換されます。