Step Functions を使用した DynamoDB API の呼び出し

Step Functions AWS は特定のサービスを Amazon ステートメント言語 (ASL) から直接制御できます。詳細については、「他の サービスでの使用」および「サービス API にパラメータを渡す」を参照してください。

注記

Step Functions のタスクには入力データまたは結果データの最大サイズにはクォータがあります。これにより、別のサービスとの間でデータを送受信するときに、UTF-8 でエンコードされた文字列として 256 KB のデータに制限されます。ステートマシンの実行に関連するクォータ を参照してください。

最適化された DynamoDB インテグレーションと DynamoDB AWS SDK インテグレーションの違い

• レスポンスのリクエスト 統合パターンの最適化はありません。

• タスクトークンのコールバックまで待機する 統合パターンはサポートされていません。

• 最適化された統合では、GetItem、PutItem、UpdateItem、および DeleteItem API アクションのみを使用できます。などその他の API CreateTableアクションは、DynamoDB AWS SDK インテグレーションを使用して利用できます。

サポートされている Amazon DynamoDB API および構文:

• GetItem

  • リクエストの構文

  • サポートされているパラメータ:

    • Key

    • TableName

    • AttributesToGet

    • ConsistentRead

    • ExpressionAttributeNames

    • ProjectionExpression

    • ReturnConsumedCapacity

  • レスポンスの構文

• PutItem

  • リクエストの構文

  • サポートされているパラメータ:

    • Item

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • レスポンスの構文

• DeleteItem

  • リクエストの構文

  • サポートされているパラメータ:

    • Key

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • レスポンスの構文

• UpdateItem

  • リクエストの構文

  • サポートされているパラメータ:

    • Key

    • TableName

    • AttributeUpdates

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

    • UpdateExpression

  • レスポンスの構文

Step Functionsのパラメータは次のように表されます。 PascalCase

ネイティブサービス API が camelCase にある場合でも、たとえば API アクションではstartSyncExecution PascalCase、次のようなパラメータを指定します。StateMachineArn

DynamoDB からメッセージを取得する Task 状態を以下に示します。

    "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"
    },
        

この状態を実例で確認するには、データレコードの転送 (Lambda、DynamoDB、Amazon SQS) サンプルプロジェクトを参照してください。

IAMStep Functions AWS 他のサービスと併用する場合の権限の設定方法については、を参照してください。統合サービスの IAM ポリシー