本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# x-amazon-apigateway-integration.response 物件
<a name="api-gateway-swagger-extensions-integration-response"></a>

 定義回應，並指定從整合回應到方法回應的參數對應或承載對應。


| 屬性名稱 | 類型 | 描述 | 
| --- | --- | --- | 
| statusCode | string | 方法回應的 HTTP 狀態碼，例如 `"200"`。這必須對應到 [OpenAPI 操作](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) CONVERT\_TO\_TEXT，將二進位承載轉換為 base64 編碼的字串或將文字承載轉換為 utf-8 編碼的字串，或以原生方式傳遞文字承載，不予修改；和 2) CONVERT\_TO\_BINARY，將文字承載轉換為 Base64 編碼的 blob，或以原生方式傳遞二進位承載，不予修改。 | 

## `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"
    }
}
```