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

Interface CallAwsServiceJsonataProps

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

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;
 CallAwsServiceJsonataProps callAwsServiceJsonataProps = CallAwsServiceJsonataProps.builder()
         .action("action")
         .iamResources(List.of("iamResources"))
         .service("service")
         // the properties below are optional
         .additionalIamStatements(List.of(policyStatement))
         .assign(Map.of(
                 "assignKey", assign))
         .comment("comment")
         .credentials(Credentials.builder()
                 .role(taskRole)
                 .build())
         .heartbeat(Duration.minutes(30))
         .heartbeatTimeout(timeout)
         .iamAction("iamAction")
         .integrationPattern(IntegrationPattern.REQUEST_RESPONSE)
         .outputs(outputs)
         .parameters(Map.of(
                 "parametersKey", parameters))
         .queryLanguage(QueryLanguage.JSON_PATH)
         .stateName("stateName")
         .taskTimeout(timeout)
         .timeout(Duration.minutes(30))
         .build();

See Also:

  • 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 state machine 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.

    • getService

      @Stability(Stable) @NotNull String getService()
      The AWS service to call.

      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

    • getIamAction

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

      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.

      Use PascalCase for the parameter names.

      Default: - no parameters

    • builder

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