Llamar a las API de DynamoDB con Step Functions

Step Functions puede controlar ciertos AWS servicios directamente desde Lenguaje de estados de Amazon (ASL). Para obtener más información, consulte Trabajo con otros servicios y Cómo pasar parámetros a una API de servicio.

nota

Hay una cuota para el tamaño máximo de los datos de entrada o resultado para una tarea en Step Functions. Esto limita a 256 KB de datos como cadena codificada en UTF-8 al enviar o recibir datos de otro servicio. Consulte Cuotas relacionadas con ejecuciones de máquinas de estado.

En qué se diferencia la integración optimizada de DynamoDB de la integración del SDK de DynamoDB AWS

• No hay ninguna optimización para el patrón de integración Respuesta de la solicitud.

• No se admite el patrón de integración Cómo esperar una devolución de llamada con el token de tarea.

• Solo las acciones de la API GetItem, PutItem, UpdateItem y DeleteItem están disponibles a través de la integración optimizada. Otras acciones de la API, como las que CreateTableestán disponibles mediante la integración del SDK de AWS DynamoDB.

API y sintaxis de Amazon DynamoDB compatibles:

• GetItem

  • Sintaxis de la solicitud

  • Parámetros admitidos:

    • Key

    • TableName

    • AttributesToGet

    • ConsistentRead

    • ExpressionAttributeNames

    • ProjectionExpression

    • ReturnConsumedCapacity

  • Sintaxis de la respuesta

• PutItem

  • Sintaxis de la solicitud

  • Parámetros admitidos:

    • Item

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • Sintaxis de la respuesta

• DeleteItem

  • Sintaxis de la solicitud

  • Parámetros admitidos:

    • Key

    • TableName

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

  • Sintaxis de la respuesta

• UpdateItem

  • Sintaxis de la solicitud

  • Parámetros admitidos:

    • Key

    • TableName

    • AttributeUpdates

    • ConditionalOperator

    • ConditionExpression

    • Expected

    • ExpressionAttributeNames

    • ExpressionAttributeValues

    • ReturnConsumedCapacity

    • ReturnItemCollectionMetrics

    • ReturnValues

    • UpdateExpression

  • Sintaxis de la respuesta

Los parámetros de se Step Functions expresan en PascalCase

Incluso si la API del servicio nativo está en CamelCase, por ejemplo, la startSyncExecution acción de la API, se especifican parámetros PascalCase en, como:. StateMachineArn

A continuación se muestra un estado Task que recupera un mensaje de 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"
    },
        

Para ver un ejemplo práctico de este estado, consulte el proyecto de muestra Transferencia de registros de datos (Lambda, DynamoDB y Amazon SQS).

Para obtener información sobre cómo configurar IAM los permisos cuando se utilizan Step Functions con otros AWS servicios, consulte. Políticas de IAM para servicios integrados