Package software.amazon.awscdk.services.apigateway

Interface IntegrationResponse

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

IntegrationResponse.Jsii$Proxy

@Generated(value="jsii-pacmak/1.127.0 (build 2117ad5)",
           date="2026-03-31T09:54:24.051Z")
@Stability(Stable)
public interface IntegrationResponse
extends software.amazon.jsii.JsiiSerializable

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.apigateway.*;
 IntegrationResponse integrationResponse = IntegrationResponse.builder()
         .statusCode("statusCode")
         // the properties below are optional
         .contentHandling(ContentHandling.CONVERT_TO_BINARY)
         .responseParameters(Map.of(
                 "responseParametersKey", "responseParameters"))
         .responseTemplates(Map.of(
                 "responseTemplatesKey", "responseTemplates"))
         .selectionPattern("selectionPattern")
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	IntegrationResponse.Builder	A builder for IntegrationResponse
static final class	IntegrationResponse.Jsii$Proxy	An implementation for IntegrationResponse

Method Summary

Modifier and Type	Method	Description
static IntegrationResponse.Builder	builder()
default ContentHandling	getContentHandling()	Specifies how to handle request payload content type conversions.
default Map<String,String>	getResponseParameters()	The response parameters from the backend response that API Gateway sends to the method response.
default Map<String,String>	getResponseTemplates()	The templates that are used to transform the integration response body.
default String	getSelectionPattern()	Specifies the regular expression (regex) pattern used to choose an integration response based on the response from the back end.
String	getStatusCode()	The status code that API Gateway uses to map the integration response to a MethodResponse status code.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getStatusCode

@Stability(Stable)
@NotNull
String getStatusCode()

The status code that API Gateway uses to map the integration response to a MethodResponse status code.

getContentHandling

@Stability(Stable)
@Nullable
default ContentHandling getContentHandling()

Specifies how to handle request payload content type conversions.

Default: none the request payload is passed through from the method request to the integration request without modification.

getResponseParameters

@Stability(Stable)
@Nullable
default Map<String,String> getResponseParameters()

The response parameters from the backend response that API Gateway sends to the method response.

Use the destination as the key and the source as the value:

• The destination must be an existing response parameter in the MethodResponse property.
• The source must be an existing method request parameter or a static value. You must enclose static values in single quotation marks and pre-encode these values based on the destination specified in the request.

See Also:

• https://docs.aws.amazon.com/apigateway/latest/developerguide/request-response-data-mappings.html

getResponseTemplates

@Stability(Stable)
@Nullable
default Map<String,String> getResponseTemplates()

The templates that are used to transform the integration response body.

Specify templates as key-value pairs, with a content type as the key and a template as the value.

See Also:

• https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html

getSelectionPattern

@Stability(Stable)
@Nullable
default String getSelectionPattern()

Specifies the regular expression (regex) pattern used to choose an integration response based on the response from the back end.

For example, if the success response returns nothing and the error response returns some string, you could use the .+ regex to match error response. However, make sure that the error response does not contain any newline (\n) character in such cases. If the back end is an AWS Lambda function, the AWS Lambda function error header is matched. For all other HTTP and AWS back ends, the HTTP status code is matched.

See Also:

• https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-integration-settings-integration-response.html

builder

@Stability(Stable)
static IntegrationResponse.Builder builder()

Returns:

a IntegrationResponse.Builder of IntegrationResponse