Call DynamoDB APIs with Step Functions - AWS Step Functions
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with AWS services in China.

Call DynamoDB APIs with Step Functions

Step Functions can control certain AWS services directly from the Amazon States Language. For more information about working with AWS Step Functions and its integrations, see the following:

Note

There is a quota for the maximum input or result data size for a task in Step Functions. This restricts you to 262,144 bytes of data as a UTF-8 encoded string when you send to, or receive data from, another service. See Quotas Related to State Machine Executions.

Supported Amazon DynamoDB APIs and syntax:

The following is a Task state that retrieves a message from DynamoDB. 

    "Read Next Message from DynamoDB": {
      "Type": "Task",
      "Resource": "arn:aws:states:::dynamodb:getItem",
      "Parameters": {
        "TableName": "TransferDataRecords-DDBTable-3I41R5L5EAGT",
        "Key": {
          "MessageId": {"S.$": "$.List[0]"}
        }
      },
      "ResultPath": "$.DynamoDB",
      "Next": "Send Message to SQS"
    },
Note

You cannot pass a map or list to DynamoDB inside a map.

To see this state in a working example, see the Transfer Data Records (Lambda, DynamoDB, Amazon SQS) sample project.

For information on how to configure IAM when using Step Functions with other AWS services, see IAM Policies for Integrated Services.