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

Interface CallAwsServiceCrossRegionJsonataProps

All Superinterfaces:
AssignableStateOptions, software.amazon.jsii.JsiiSerializable, JsonataCommonOptions, StateBaseProps, TaskStateBaseOptions, TaskStateJsonataBaseProps
All Known Implementing Classes:
CallAwsServiceCrossRegionJsonataProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)", date="2025-10-29T11:15:49.623Z") @Stability(Stable) public interface CallAwsServiceCrossRegionJsonataProps extends software.amazon.jsii.JsiiSerializable, TaskStateJsonataBaseProps
Properties for calling an AWS service's API action using JSONata from your state machine across regions.

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.iam.*;
 import software.amazon.awscdk.services.stepfunctions.*;
 import software.amazon.awscdk.services.stepfunctions.tasks.*;
 Object assign;
 Object outputs;
 Object parameters;
 PolicyStatement policyStatement;
 TaskRole taskRole;
 Timeout timeout;
 CallAwsServiceCrossRegionJsonataProps callAwsServiceCrossRegionJsonataProps = CallAwsServiceCrossRegionJsonataProps.builder()
         .action("action")
         .iamResources(List.of("iamResources"))
         .region("region")
         .service("service")
         // the properties below are optional
         .additionalIamStatements(List.of(policyStatement))
         .assign(Map.of(
                 "assignKey", assign))
         .comment("comment")
         .credentials(Credentials.builder()
                 .role(taskRole)
                 .build())
         .endpoint("endpoint")
         .heartbeat(Duration.minutes(30))
         .heartbeatTimeout(timeout)
         .iamAction("iamAction")
         .integrationPattern(IntegrationPattern.REQUEST_RESPONSE)
         .outputs(outputs)
         .parameters(Map.of(
                 "parametersKey", parameters))
         .queryLanguage(QueryLanguage.JSON_PATH)
         .retryOnServiceExceptions(false)
         .stateName("stateName")
         .taskTimeout(timeout)
         .timeout(Duration.minutes(30))
         .build();

  • Method Details

    • getAction

      @Stability(Stable) @NotNull String getAction()
      The API action to call.

      Use camelCase.

    • getIamResources

      @Stability(Stable) @NotNull List<String> getIamResources()
      The resources for the IAM statement that will be added to the Lambda function role's policy to allow the state machine to make the API call.

    • getRegion

      @Stability(Stable) @NotNull String getRegion()
      The AWS region to call this AWS API for.

      Example: 

       "us-east-1";

    • getService

      @Stability(Stable) @NotNull String getService()
      The AWS service to call in AWS SDK for JavaScript v3 format.

      Example: 

       "s3";

      See Also:

    • getAdditionalIamStatements

      @Stability(Stable) @Nullable default List<PolicyStatement> getAdditionalIamStatements()
      Additional IAM statements that will be added to the state machine role's policy.

      Use in the case where the call requires more than a single statement to be executed, e.g. rekognition:detectLabels requires also S3 permissions to read the object on which it must act.

      Default: - no additional statements are added

    • getEndpoint

      @Stability(Stable) @Nullable default String getEndpoint()
      The AWS API endpoint.

      Default: Do not override API endpoint.

    • getIamAction

      @Stability(Stable) @Nullable default String getIamAction()
      The action for the IAM statement that will be added to the Lambda function role's policy to allow the state machine to make the API call.

      By default the action for this IAM statement will be service:action.

      Use in the case where the IAM action name does not match with the API service/action name, e.g. s3:ListBuckets requires s3:ListAllMyBuckets.

      Default: - service:action

    • getParameters

      @Stability(Stable) @Nullable default Map<String,Object> getParameters()
      Parameters for the API action call in AWS SDK for JavaScript v3 format.

      Default: - no parameters

    • getRetryOnServiceExceptions

      @Stability(Stable) @Nullable default Boolean getRetryOnServiceExceptions()
      Whether to retry on the backend Lambda service exceptions.

      This handles Lambda.ServiceException, Lambda.AWSLambdaException, Lambda.SdkClientException, and Lambda.ClientExecutionTimeoutException with an interval of 2 seconds, a back-off rate of 2 and 6 maximum attempts.

      Default: true

      See Also:

    • builder

      @Stability(Stable) static CallAwsServiceCrossRegionJsonataProps.Builder builder()
      Returns:
      a CallAwsServiceCrossRegionJsonataProps.Builder of CallAwsServiceCrossRegionJsonataProps