

# Configurar uma resposta de gateway usando a API REST do API Gateway
<a name="set-up-gateway-response-using-the-api"></a>

 Antes de personalizar uma resposta de gateway usando a API REST do API Gateway, você já deve ter criado uma API e obtido seu identificador. Para recuperar o identificador da API, você pode seguir a relação do link [restapi:gateway-responses](https://docs.aws.amazon.com/apigateway/latest/api/API_GetGatewayResponses.html) e examinar o resultado. 

**Para personalizar uma resposta de gateway usando a API REST do API Gateway**

1. Para substituir uma instância de [GatewayResponse](https://docs.aws.amazon.com/apigateway/latest/api/API_GatewayResponse.html) inteira, chame a ação [gatewayresponse:put](https://docs.aws.amazon.com/apigateway/latest/api/API_PutGatewayResponse.html). Especifique um [responseType](https://docs.aws.amazon.com/apigateway/latest/api/API_GatewayResponse.html#responseType) desejado no parâmetro de caminho de URL e forneça na carga útil da solicitação os mapeamentos [statusCode](https://docs.aws.amazon.com/apigateway/latest/api/API_GatewayResponse.html#statusCode), [responseParameters](https://docs.aws.amazon.com/apigateway/latest/api/API_GatewayResponse.html#responseParameters) e [responseTemplates](https://docs.aws.amazon.com/apigateway/latest/api/API_GatewayResponse.html#responseTemplates).

1. Para atualizar parte de uma instância `GatewayResponse`, chame a ação [gatewayresponse:update](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateGatewayResponse.html). Especifique um `responseType` desejado no parâmetro de caminho de URL e forneça na carga útil da solicitação as propriedades individuais `GatewayResponse` desejadas, por exemplo, o mapeamento `responseParameters` ou `responseTemplates`.