ApiGatewayV2 / Client / get_integration_responses

get_integration_responses#

ApiGatewayV2.Client.get_integration_responses(**kwargs)#

Gets the IntegrationResponses for an Integration.

See also: AWS API Documentation

Request Syntax

response = client.get_integration_responses(
    ApiId='string',
    IntegrationId='string',
    MaxResults='string',
    NextToken='string'
)
Parameters:

  • ApiId (string) –

    [REQUIRED]

    The API identifier.

  • IntegrationId (string) –

    [REQUIRED]

    The integration ID.

  • MaxResults (string) – The maximum number of elements to be returned for this resource.

  • NextToken (string) – The next page of elements from this collection. Not valid for the last element of the collection.

Return type:

dict

Returns:

Response Syntax

{
    'Items': [
        {
            'ContentHandlingStrategy': 'CONVERT_TO_BINARY'|'CONVERT_TO_TEXT',
            'IntegrationResponseId': 'string',
            'IntegrationResponseKey': 'string',
            'ResponseParameters': {
                'string': 'string'
            },
            'ResponseTemplates': {
                'string': 'string'
            },
            'TemplateSelectionExpression': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    Success

    • Items (list) –

      The elements from this collection.

      • (dict) –

        Represents an integration response.

        • ContentHandlingStrategy (string) –

          Supported 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:

          CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded string to the corresponding binary blob.

          CONVERT_TO_TEXT: Converts a response payload from a binary blob to a Base64-encoded string.

          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.

        • IntegrationResponseId (string) –

          The integration response ID.

        • IntegrationResponseKey (string) –

          The integration response key.

        • ResponseParameters (dict) –

          A 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.

          • (string) –

            • (string) –

              A string with a length between [1-512].

        • ResponseTemplates (dict) –

          The 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.

          • (string) –

            • (string) –

              A string with a length between [0-32768].

        • TemplateSelectionExpression (string) –

          The template selection expressions for the integration response.

    • NextToken (string) –

      The next page of elements from this collection. Not valid for the last element of the collection.

Exceptions