Package software.amazon.awscdk.services.stepfunctions.tasks

Class CallApiGatewayRestApiEndpoint

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.services.stepfunctions.State
software.amazon.awscdk.services.stepfunctions.TaskStateBase
software.amazon.awscdk.services.stepfunctions.tasks.CallApiGatewayRestApiEndpoint
All Implemented Interfaces:
IChainable, INextable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)", date="2025-12-12T17:54:23.637Z") @Stability(Stable) public class CallApiGatewayRestApiEndpoint extends TaskStateBase
Call REST API endpoint as a Task.

Be aware that the header values must be arrays. When passing the Task Token in the headers field WAIT_FOR_TASK_TOKEN integration, use JsonPath.array() to wrap the token in an array: 

 import software.amazon.awscdk.services.apigateway.*;
 RestApi api;
 CallApiGatewayRestApiEndpoint.Builder.create(this, "Endpoint")
         .api(api)
         .stageName("Stage")
         .method(HttpMethod.PUT)
         .integrationPattern(IntegrationPattern.WAIT_FOR_TASK_TOKEN)
         .headers(TaskInput.fromObject(Map.of(
                 "TaskToken", JsonPath.array(JsonPath.getTaskToken()))))
         .build();

Example: 

 import software.amazon.awscdk.services.apigateway.*;
 RestApi api;
 CallApiGatewayRestApiEndpoint.jsonata(this, "Endpoint", CallApiGatewayRestApiEndpointJsonataProps.builder()
         .api(api)
         .stageName("Stage")
         .method(HttpMethod.PUT)
         .integrationPattern(IntegrationPattern.WAIT_FOR_TASK_TOKEN)
         .headers(TaskInput.fromObject(Map.of(
                 "TaskToken", "{% States.Array($states.context.taskToken) %}")))
         .build());

See Also:

  • Field Details

    • PROPERTY_INJECTION_ID

      @Stability(Stable) public static final String PROPERTY_INJECTION_ID
      Uniquely identifies this class.

  • Constructor Details

    • CallApiGatewayRestApiEndpoint

      protected CallApiGatewayRestApiEndpoint(software.amazon.jsii.JsiiObjectRef objRef)

    • CallApiGatewayRestApiEndpoint

      protected CallApiGatewayRestApiEndpoint(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • CallApiGatewayRestApiEndpoint

      @Stability(Stable) public CallApiGatewayRestApiEndpoint(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull CallApiGatewayRestApiEndpointProps props)
      Parameters:
      scope - This parameter is required.
      id - Descriptive identifier for this chainable. This parameter is required.
      props - This parameter is required.

  • Method Details

    • jsonata

      @Stability(Stable) @NotNull public static CallApiGatewayRestApiEndpoint jsonata(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull CallApiGatewayRestApiEndpointJsonataProps props)
      Call REST API endpoint as a Task using JSONata.

      Be aware that the header values must be arrays. When passing the Task Token in the headers field WAIT_FOR_TASK_TOKEN integration, use JsonPath.array() to wrap the token in an array: 

       import software.amazon.awscdk.services.apigateway.*;
 RestApi api;
 CallApiGatewayRestApiEndpoint.jsonata(this, "Endpoint", CallApiGatewayRestApiEndpointJsonataProps.builder()
         .api(api)
         .stageName("Stage")
         .method(HttpMethod.PUT)
         .integrationPattern(IntegrationPattern.WAIT_FOR_TASK_TOKEN)
         .headers(TaskInput.fromObject(Map.of(
                 "TaskToken", "{% States.Array($states.context.taskToken) %}")))
         .build());

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props - This parameter is required.
      See Also:

    • jsonPath

      @Stability(Stable) @NotNull public static CallApiGatewayRestApiEndpoint jsonPath(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull CallApiGatewayRestApiEndpointJsonPathProps props)
      Call REST API endpoint as a Task using JSONPath.

      Be aware that the header values must be arrays. When passing the Task Token in the headers field WAIT_FOR_TASK_TOKEN integration, use JsonPath.array() to wrap the token in an array: 

       import software.amazon.awscdk.services.apigateway.*;
 RestApi api;
 CallApiGatewayRestApiEndpoint.jsonPath(this, "Endpoint", CallApiGatewayRestApiEndpointJsonPathProps.builder()
         .api(api)
         .stageName("Stage")
         .method(HttpMethod.PUT)
         .integrationPattern(IntegrationPattern.WAIT_FOR_TASK_TOKEN)
         .headers(TaskInput.fromObject(Map.of(
                 "TaskToken", JsonPath.array(JsonPath.getTaskToken()))))
         .build());

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props - This parameter is required.
      See Also:

    • createPolicyStatements

      @Stability(Stable) @NotNull protected List<PolicyStatement> createPolicyStatements()

    • getApiEndpoint

      @Stability(Stable) @NotNull protected String getApiEndpoint()

    • getArnForExecuteApi

      @Stability(Stable) @NotNull protected String getArnForExecuteApi()

    • getStageName

      @Stability(Stable) @Nullable protected String getStageName()

    • getTaskMetrics

      @Stability(Stable) @Nullable protected TaskMetricsConfig getTaskMetrics()
      Specified by:
      getTaskMetrics in class TaskStateBase

    • getTaskPolicies

      @Stability(Stable) @Nullable protected List<PolicyStatement> getTaskPolicies()
      Specified by:
      getTaskPolicies in class TaskStateBase