interface CfnIntegrationResponseProps

Language	Type name
.NET	`Amazon.CDK.AWS.Apigatewayv2.CfnIntegrationResponseProps`
Go	`github.com/aws/aws-cdk-go/awscdk/v2/awsapigatewayv2#CfnIntegrationResponseProps`
Java	`software.amazon.awscdk.services.apigatewayv2.CfnIntegrationResponseProps`
Python	`aws_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

Name	Type	Description
apiId	`string`	The API identifier.
integrationId	`string`	The integration ID.
integrationResponseKey	`string`	The integration response key.
contentHandlingStrategy?	`string`	Supported only for WebSocket APIs.
responseParameters?	`any`	A key-value map specifying response parameters that are passed to the method response from the backend.
responseTemplates?	`any`	The collection of response templates for the integration response as a string-to-string map of key-value pairs.
templateSelectionExpression?	`string`	The 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.