Chiama le API DynamoDB con Step Functions

Step Functions può controllare determinati AWS servizi direttamente da Amazon States Language (ASL). Per ulteriori informazioni, consultare Uso di altri servizi e Passa i parametri a un'API di servizio.

Nota

Esiste una quota per la dimensione massima dei dati di input o risultato per un'attività in Step Functions. Ciò limita a 256 KB di dati come stringa con codifica UTF-8 quando si inviano o si ricevono dati da un altro servizio. Per informazioni, consulta Quote relative alle esecuzioni di macchine a stati.

In che modo l'integrazione ottimizzata di DynamoDB è diversa dall'integrazione DynamoDB SDK AWS

• Non esiste alcuna ottimizzazione per il modello di integrazione. Richiesta e risposta

• Il modello di Attendere un callback con il token dell’attività integrazione non è supportato.

• Solo GetItem, PutItemUpdateItem, e le azioni DeleteItemAPI sono disponibili tramite l'integrazione ottimizzata. Altre azioni API, ad esempio, CreateTablesono disponibili utilizzando l'integrazione con DynamoDB AWS SDK.

API e sintassi di Amazon DynamoDB supportate:

• GetItem

  • Sintassi della richiesta

  • Parametri supportati:

    • Key

    • TableName

    • AttributesToGet

    • ConsistentRead

    • ExpressionAttributeNames

    • ProjectionExpression

    • ReturnConsumedCapacity

  • Sintassi della risposta

• PutItem

  • Sintassi della richiesta

  • Parametri supportati:

    • Item

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • Sintassi della risposta

• DeleteItem

  • Sintassi della richiesta

  • Parametri supportati:

    • Key

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • Sintassi della risposta

• UpdateItem

  • Sintassi della richiesta

  • Parametri supportati:

    • Key

    • TableName

    • AttributeUpdates

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

    • UpdateExpression

  • Sintassi della risposta

I parametri in sono espressi in Step Functions PascalCase

Anche se l'API del servizio nativo è in CamelCase, ad esempio l'startSyncExecutionazione API, si specificano parametri PascalCase in, ad esempio:. StateMachineArn

Di seguito è riportato uno Task stato che recupera un messaggio da 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"
    },
        

Per visualizzare questo stato in un esempio pratico, consultare il progetto di esempio Trasferisci record di dati (Lambda,DynamoDB,Amazon SQS).

Per informazioni su come configurare le IAM autorizzazioni quando vengono utilizzate Step Functions con altri AWS servizi, consulta. Politiche IAM per servizi integrati