# x-amazon-apigateway-integration.response オブジェクト
<a name="api-gateway-swagger-extensions-integration-response"></a>

 レスポンスを定義し、統合レスポンスからメソッドレスポンスまでパラメーターマッピングまたはペイロードマッピングを指定します。


| プロパティ名 | タイプ | 説明 | 
| --- | --- | --- | 
| statusCode | string |  メソッドレスポンスの HTTP ステータスコード (例: `"200"`)。これは、[OpenAPI Operation](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md#operation-object) `responses` フィールドで一致しているレスポンスに対応している必要があります。  | 
| responseTemplates | [x-amazon-apigateway-integration.responseTemplates オブジェクト](api-gateway-swagger-extensions-integration-responseTemplates.md) |  レスポンスのペイロード用に MIME タイプ固有のマッピングテンプレートを指定します。  | 
| responseParameters | [x-amazon-apigateway-integration.responseParameters オブジェクト](api-gateway-swagger-extensions-integration-responseParameters.md) |  レスポンス用にパラメーターマッピングを指定します。メソッドの `header` パラメータにマッピングできるのは、統合レスポンスの `body` パラメータおよび `header` パラメータだけです。  | 
| contentHandling | string | レスポンスのペイロードエンコード変換タイプ。有効な値は、1) バイナリペイロードを Base64 でエンコードされた文字列に変換する場合、テキストペイロードを CONVERT\$1TO\$1TEXT でエンコードされた文字列に変換する場合、変更なしでテキストペイロードをネイティブに渡す場合の utf-8 と、2) テキストペイロードを Base64 でデコードされた BLOB に変換する場合、または変更なしでバイナリペイロードをネイティブに渡す場合の CONVERT\$1TO\$1BINARY です。 | 

## `x-amazon-apigateway-integration.response` の例
<a name="api-gateway-swagger-extensions-response-example"></a>

次の例では、バックエンドから `302` または `application/json` の MIME タイプのペイロードを派生させるメソッド用の `application/xml` レスポンスが定義されています。このレスポンスでは、指定のマッピングテンプレートが使用され、メソッドの `Location` ヘッダーで統合レスポンスからのリダイレクト URL が返されます。

```
{
    "statusCode" : "302",
    "responseTemplates" : {
         "application/json" : "#set ($root=$input.path('$')) { \"stage\": \"$root.name\", \"user-id\": \"$root.key\" }",
         "application/xml" : "#set ($root=$input.path('$')) <stage>$root.name</stage> "
    },
    "responseParameters" : {
        "method.response.header.Location": "integration.response.body.redirect.url"
    }
}
```