aws-cdk-lib.aws_apigatewayv2.CfnIntegrationResponseProps

interface CfnIntegrationResponseProps

LanguageType name
.NETAmazon.CDK.AWS.Apigatewayv2.CfnIntegrationResponseProps
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsapigatewayv2#CfnIntegrationResponseProps
Javasoftware.amazon.awscdk.services.apigatewayv2.CfnIntegrationResponseProps
Pythonaws_cdk.aws_apigatewayv2.CfnIntegrationResponseProps
TypeScript aws-cdk-lib » aws_apigatewayv2 » CfnIntegrationResponseProps

Properties for defining a CfnIntegrationResponse.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_apigatewayv2 as apigatewayv2 } from 'aws-cdk-lib';

declare const responseParameters: any;
declare const responseTemplates: any;
const cfnIntegrationResponseProps: apigatewayv2.CfnIntegrationResponseProps = {
  apiId: 'apiId',
  integrationId: 'integrationId',
  integrationResponseKey: 'integrationResponseKey',

  // the properties below are optional
  contentHandlingStrategy: 'contentHandlingStrategy',
  responseParameters: responseParameters,
  responseTemplates: responseTemplates,
  templateSelectionExpression: 'templateSelectionExpression',
};

Properties

NameTypeDescription
apiIdstringThe API identifier.
integrationIdstringThe integration ID.
integrationResponseKeystringThe integration response key.
contentHandlingStrategy?stringSupported only for WebSocket APIs.
responseParameters?anyA key-value map specifying response parameters that are passed to the method response from the backend.
responseTemplates?anyThe collection of response templates for the integration response as a string-to-string map of key-value pairs.
templateSelectionExpression?stringThe template selection expression for the integration response.

apiId

Type: string

The API identifier.


integrationId

Type: string

The integration ID.


integrationResponseKey

Type: string

The integration response key.


contentHandlingStrategy?

Type: string (optional)

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.


responseParameters?

Type: any (optional)

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.


responseTemplates?

Type: any (optional)

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.


templateSelectionExpression?

Type: string (optional)

The template selection expression for the integration response.

Supported only for WebSocket APIs.