Package software.amazon.awscdk.services.apigateway

Interface StepFunctionsExecutionIntegrationOptions

All Superinterfaces:

IntegrationOptions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

StepFunctionsExecutionIntegrationOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-13T16:09:57.946Z")
@Stability(Stable)
public interface StepFunctionsExecutionIntegrationOptions
extends software.amazon.jsii.JsiiSerializable, IntegrationOptions

Options when configuring Step Functions synchronous integration with Rest API.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.*;
 import software.amazon.awscdk.services.apigateway.*;
 import software.amazon.awscdk.services.iam.*;
 Role role;
 VpcLink vpcLink;
 StepFunctionsExecutionIntegrationOptions stepFunctionsExecutionIntegrationOptions = StepFunctionsExecutionIntegrationOptions.builder()
         .authorizer(false)
         .cacheKeyParameters(List.of("cacheKeyParameters"))
         .cacheNamespace("cacheNamespace")
         .connectionType(ConnectionType.INTERNET)
         .contentHandling(ContentHandling.CONVERT_TO_BINARY)
         .credentialsPassthrough(false)
         .credentialsRole(role)
         .headers(false)
         .integrationResponses(List.of(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()))
         .passthroughBehavior(PassthroughBehavior.WHEN_NO_MATCH)
         .path(false)
         .querystring(false)
         .requestContext(RequestContext.builder()
                 .accountId(false)
                 .apiId(false)
                 .apiKey(false)
                 .authorizerPrincipalId(false)
                 .caller(false)
                 .cognitoAuthenticationProvider(false)
                 .cognitoAuthenticationType(false)
                 .cognitoIdentityId(false)
                 .cognitoIdentityPoolId(false)
                 .httpMethod(false)
                 .requestId(false)
                 .resourceId(false)
                 .resourcePath(false)
                 .sourceIp(false)
                 .stage(false)
                 .user(false)
                 .userAgent(false)
                 .userArn(false)
                 .build())
         .requestParameters(Map.of(
                 "requestParametersKey", "requestParameters"))
         .requestTemplates(Map.of(
                 "requestTemplatesKey", "requestTemplates"))
         .timeout(Duration.minutes(30))
         .useDefaultMethodResponses(false)
         .vpcLink(vpcLink)
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static StepFunctionsExecutionIntegrationOptions.Builder	builder()
default Boolean	getAuthorizer()	If the whole authorizer object, including custom context values should be in the execution input.
default Boolean	getHeaders()	Check if header is to be included inside the execution input.
default Boolean	getPath()	Check if path is to be included inside the execution input.
default Boolean	getQuerystring()	Check if querystring is to be included inside the execution input.
default RequestContext	getRequestContext()	Which details of the incoming request must be passed onto the underlying state machine, such as, account id, user identity, request id, etc.
default Boolean	getUseDefaultMethodResponses()	Whether to add default response models with 200, 400, and 500 status codes to the method.

Methods inherited from interface software.amazon.awscdk.services.apigateway.IntegrationOptions

getCacheKeyParameters, getCacheNamespace, getConnectionType, getContentHandling, getCredentialsPassthrough, getCredentialsRole, getIntegrationResponses, getPassthroughBehavior, getRequestParameters, getRequestTemplates, getTimeout, getVpcLink

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getAuthorizer

@Stability(Stable)
@Nullable
default Boolean getAuthorizer()

If the whole authorizer object, including custom context values should be in the execution input.

The execution input will include a new key authorizer:

{ "body": {}, "authorizer": { "key": "value" } }

Default: false

getHeaders

@Stability(Stable)
@Nullable
default Boolean getHeaders()

Check if header is to be included inside the execution input.

The execution input will include a new key headers:

{ "body": {}, "headers": { "header1": "value", "header2": "value" } }

Default: false

getPath

@Stability(Stable)
@Nullable
default Boolean getPath()

Check if path is to be included inside the execution input.

The execution input will include a new key path:

{ "body": {}, "path": { "resourceName": "resourceValue" } }

Default: true

getQuerystring

@Stability(Stable)
@Nullable
default Boolean getQuerystring()

Check if querystring is to be included inside the execution input.

The execution input will include a new key queryString:

{ "body": {}, "querystring": { "key": "value" } }

Default: true

getRequestContext

@Stability(Stable)
@Nullable
default RequestContext getRequestContext()

Which details of the incoming request must be passed onto the underlying state machine, such as, account id, user identity, request id, etc.

The execution input will include a new key requestContext:

{ "body": {}, "requestContext": { "key": "value" } }

Default: - all parameters within request context will be set as false

getUseDefaultMethodResponses

@Stability(Stable)
@Nullable
default Boolean getUseDefaultMethodResponses()

Whether to add default response models with 200, 400, and 500 status codes to the method.

Default: true

builder

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

Returns:

a StepFunctionsExecutionIntegrationOptions.Builder of StepFunctionsExecutionIntegrationOptions