Appelez les API DynamoDB avec Step Functions

Step Functions peut contrôler certains AWS services directement depuis Amazon States Language (ASL). Pour en savoir plus, consultez Utilisation avec d'autres services et Transmettre des paramètres à une API de service.

Note

Il existe un quota pour la taille maximale des données d'entrée ou de résultat pour une tâche dans Step Functions. Cela vous limite à 256 Ko de données sous forme de chaîne codée en UTF-8 lorsque vous envoyez ou recevez des données d'un autre service. veuillez consulter Quotas liés aux exécutions par les machines de l'État.

En quoi l'intégration DynamoDB optimisée est différente de l'intégration DynamoDB SDK AWS

• Il n'y a aucune optimisation pour le modèle Réponse à la requête d'intégration.

• Le modèle Attendre un rappel avec le jeton de tâche d'intégration n'est pas pris en charge.

• Seules GetItemles actions PutItem, UpdateItem, et DeleteItemAPI sont disponibles grâce à une intégration optimisée. D'autres actions d'API, telles que celles CreateTabledisponibles à l'aide de l'intégration du SDK AWS DynamoDB.

API et syntaxe Amazon DynamoDB prises en charge :

• GetItem

  • Syntaxe de demande

  • Paramètres pris en charge :

    • Key

    • TableName

    • AttributesToGet

    • ConsistentRead

    • ExpressionAttributeNames

    • ProjectionExpression

    • ReturnConsumedCapacity

  • Syntaxe de réponse

• PutItem

  • Syntaxe de demande

  • Paramètres pris en charge :

    • Item

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • Syntaxe de réponse

• DeleteItem

  • Syntaxe de demande

  • Paramètres pris en charge :

    • Key

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • Syntaxe de réponse

• UpdateItem

  • Syntaxe de demande

  • Paramètres pris en charge :

    • Key

    • TableName

    • AttributeUpdates

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

    • UpdateExpression

  • Syntaxe de réponse

Les paramètres in Step Functions sont exprimés en PascalCase

Même si l'API de service native se trouve dans CamelCase, par exemple l'startSyncExecutionaction d'API, vous spécifiez des paramètres PascalCase dans, tels que :. StateMachineArn

L'Taskétat suivant permet de récupérer un message depuis 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"
    },
        

Pour voir cet état dans un exemple pratique, consultez l'exemple de projet Transférer des enregistrements de données (Lambda,DynamoDB,Amazon SQS).

Pour plus d'informations sur la configuration IAM des autorisations lors de l'utilisation Step Functions avec d'autres AWS services, consultezPolitiques IAM pour les services intégrés.