Skip to main content

integration_response

Gets an individual integration_response resource

Overview

Nameintegration_response
TypeResource
Descriptionintegration_response
Idawscc.apigatewayv2.integration_response

Fields

NameDatatypeDescription
integration_response_idstring
response_templatesobjectThe collection of response templates for the integration response as a string-to-string map of key-value pairs. Response templates are represented as a key/value map, with a content-type as the key and a template as the value.
template_selection_expressionstringThe template selection expression for the integration response. Supported only for WebSocket APIs.
response_parametersobjectA key-value map specifying response parameters that are passed to the method response from the backend. The key is a method response header parameter name and the mapped value is an integration response header value, a static value enclosed within a pair of single quotes, or a JSON expression from the integration response body. The mapping key must match the pattern of ``method.response.header.{name}``, where name is a valid and unique header name. The mapped non-static value must match the pattern of ``integration.response.header.{name}`` or ``integration.response.body.{JSON-expression}``, where ``{name}`` is a valid and unique response header name and ``{JSON-expression}`` is a valid JSON expression without the ``$`` prefix.
content_handling_strategystringSupported only for WebSocket APIs. Specifies how to handle response payload content type conversions. Supported values are ``CONVERT_TO_BINARY`` and ``CONVERT_TO_TEXT``, with the following behaviors:<br/> ``CONVERT_TO_BINARY``: Converts a response payload from a Base64-encoded string to the corresponding binary blob.<br/> ``CONVERT_TO_TEXT``: Converts a response payload from a binary blob to a Base64-encoded string.<br/> If this property is not defined, the response payload will be passed through from the integration response to the route response or method response without modification.
integration_idstringThe integration ID.
integration_response_keystringThe integration response key.
api_idstringThe API identifier.
regionstringAWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
integration_response_id,
response_templates,
template_selection_expression,
response_parameters,
content_handling_strategy,
integration_id,
integration_response_key,
api_id
FROM awscc.apigatewayv2.integration_response
WHERE data__Identifier = '<ApiId>|<IntegrationId>|<IntegrationResponseId>';

Permissions

To operate on the integration_response resource, the following permissions are required:

Read

apigateway:GET

Update

apigateway:PATCH,
apigateway:PUT,
apigateway:GET

Delete

apigateway:GET,
apigateway:DELETE