統合パススルーの動作
非プロキシ統合の場合は、メソッドリクエストにペイロードが含まれ、Content-Type
ヘッダーが、指定されたマッピングテンプレートに一致しないか、マッピングテンプレートが定義されていない場合は、クライアントで提供されたリクエストペイロードを、統合リクエストを通じて変換せずにバックエンドに渡す選択ができます。このプロセスは統合パススルーと呼ばれます。
プロキシ統合の場合は、API Gateway がリクエスト全体をバックエンドに渡します。パススルー動作を変更するオプションはありません。
入力リクエストの実際のパススルー動作は、統合リクエストの設定中に、指定されたマッピングテンプレートに選択したオプションと、クライアントが受信リクエストで設定する Content Type ヘッダーによって決まります。次の例では、可能なパススルー動作について示します。
例 1: application/json
コンテンツタイプで 1 つのマッピングテンプレートが統合リクエストで定義されている。
Content-Type ヘッダー\選択されたパススルーオプション | WHEN_NO_MATCH |
WHEN_NO_TEMPLATES |
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_TEMPLATES |
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 |
リクエストペイロードはテンプレートを使用して変換されます。 | リクエストペイロードはテンプレートを使用して変換されます。 | リクエストペイロードはテンプレートを使用して変換されます。 |