software.amazon.awscdk.services.stepfunctions.tasks

Interface CallAwsServiceProps

All Superinterfaces:

TaskStateBaseProps

All Known Implementing Classes:

CallAwsServiceProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:50.162Z")
public interface CallAwsServiceProps
extends TaskStateBaseProps

Properties for calling an AWS service's API action from your state machine.

Example:

 Bucket myBucket;
 CallAwsService getObject = CallAwsService.Builder.create(this, "GetObject")
         .service("s3")
         .action("getObject")
         .parameters(Map.of(
                 "Bucket", myBucket.getBucketName(),
                 "Key", JsonPath.stringAt("$.key")))
         .iamResources(List.of(myBucket.arnForObjects("*")))
         .build();
 

See Also:

https://docs.aws.amazon.com/step-functions/latest/dg/supported-services-awssdk.html

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static CallAwsServiceProps.Builder	builder()
java.lang.String	getAction() The API action to call.
default java.lang.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.
java.util.List<java.lang.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.
default java.util.Map<java.lang.String,java.lang.Object>	getParameters() Parameters for the API action call.
java.lang.String	getService() The AWS service to call.

Methods inherited from interface software.amazon.awscdk.services.stepfunctions.TaskStateBaseProps

getComment, getHeartbeat, getInputPath, getIntegrationPattern, getOutputPath, getResultPath, getResultSelector, getTimeout

Method Detail

getAction

java.lang.String getAction()

The API action to call.

Use camelCase.

getIamResources

java.util.List<java.lang.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

java.lang.String getService()

The AWS service to call.

See Also:

https://docs.aws.amazon.com/step-functions/latest/dg/supported-services-awssdk.html

getIamAction

default java.lang.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

default java.util.Map<java.lang.String,java.lang.Object> getParameters()

Parameters for the API action call.

Use PascalCase for the parameter names.

Default: - no parameters

builder

static CallAwsServiceProps.Builder builder()

Specified by:

builder in interface TaskStateBaseProps

Returns:

a CallAwsServiceProps.Builder of CallAwsServiceProps