Esta página proporciona una referencia de las acciones de AWS DynamoDB disponibles en el catálogo de acciones de automatización del flujo de trabajo. Utilice estas acciones para leer, escribir, actualizar y eliminar elementos en las tablas de DynamoDB, y para inspeccionar o modificar la configuración de las tablas directamente desde la definición de un flujo de trabajo.
Requisitos previos
Para los requisitos previos y la configuración de credenciales, consulte Configurar las credenciales de AWS.
Todas las acciones de DynamoDB aceptan las mismas entradas de autenticación. Utilice awsRoleArn (recomendado) o el par de claves de acceso.
Poner un elemento
El identificador de la acción es aws.dynamodb.putItem.
Crea un elemento nuevo, o reemplaza un elemento existente, en una tabla de DynamoDB. Utiliza el formato de bajo nivel AttributeValue de DynamoDB para el mapa item.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS de la tabla objetivo. |
|
| Cadena | Requerido. Nombre de la tabla de DynamoDB. |
|
| Mapa | Requerido. Un mapa de pares de nombre/valor de atributo en formato AttributeValue de bajo nivel de DynamoDB. Solo se requieren los atributos de la clave principal; los demás atributos son opcionales. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Una condición que se debe cumplir para que |
|
| Mapa | Opcional. Tokens de sustitución para nombres de atributos en expresiones. Utilice la sintaxis |
|
| Mapa | Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel. Utilice la sintaxis |
|
| Mapa | Opcional. Paso directo para cualquier campo |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Respuesta de |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: put-dynamodb-itemdescription: Write an order item to DynamoDBsteps: - name: putOrderItem type: action action: aws.dynamodb.putItem version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders item: orderId: { "S": "123" } status: { "S": "PLACED" } next: endObtener un elemento
El identificador de la acción es aws.dynamodb.getItem.
Recupera un solo elemento de una tabla de DynamoDB por la clave principal.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS de la tabla objetivo. |
|
| Cadena | Requerido. Nombre de la tabla de DynamoDB. |
|
| Mapa | Requerido. La clave principal del elemento a recuperar, en formato AttributeValue de bajo nivel. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Lista separada por comas de atributos a recuperar. Si se omite, se devuelven todos los atributos. |
|
| Mapa | Opcional. Tokens de sustitución para nombres de atributos en expresiones. Utilice la sintaxis |
|
| Booleano | Opcional. Si es |
|
| Mapa | Opcional. Traspaso para cualquier campo |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Contiene |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: get-dynamodb-itemdescription: Retrieve an order item from DynamoDB by primary keysteps: - name: getOrderItem type: action action: aws.dynamodb.getItem version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders key: orderId: { "S": "123" } selectors: - name: item expression: '.response.Item' next: endActualizar un elemento
El identificador de la acción es aws.dynamodb.updateItem.
Edita los atributos de un elemento existente o agrega un elemento nuevo si aún no existe.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS de la tabla objetivo. |
|
| Cadena | Requerido. Nombre de la tabla de DynamoDB. |
|
| Mapa | Requerido. La clave principal del elemento que se va a actualizar, en formato AttributeValue de bajo nivel. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Define los atributos a actualizar. Admite las acciones |
|
| Cadena | Opcional. Una condición que debe cumplirse para que |
|
| Mapa | Opcional. Tokens de sustitución para nombres de atributos en expresiones. Utilice la sintaxis |
|
| Mapa | Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel. |
|
| Mapa | Opcional. Paso directo para cualquier campo |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Contiene |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: update-dynamodb-itemdescription: Update the status of an order in DynamoDBsteps: - name: updateOrderStatus type: action action: aws.dynamodb.updateItem version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders key: orderId: { "S": "123" } updateExpression: 'SET #s = :status' expressionAttributeNames: '#s': status expressionAttributeValues: ':status': { "S": "SHIPPED" } parameters: ReturnValues: UPDATED_NEW selectors: - name: attributes expression: '.response.Attributes' next: endEliminar un elemento
El identificador de la acción es aws.dynamodb.deleteItem.
Elimina un único elemento de una tabla de DynamoDB mediante su clave principal.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS de la tabla objetivo. |
|
| Cadena | Requerido. Nombre de la tabla de DynamoDB. |
|
| Mapa | Requerido. La clave principal del elemento a eliminar, en formato AttributeValue de bajo nivel. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Una condición que debe cumplirse para que |
|
| Mapa | Opcional. Token de sustitución para nombres de atributo en expresiones. |
|
| Mapa | Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel. |
|
| Mapa | Opcional. Paso directo para cualquier campo |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Contiene |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: delete-dynamodb-itemdescription: Delete an order item from DynamoDBsteps: - name: deleteOrderItem type: action action: aws.dynamodb.deleteItem version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders key: orderId: { "S": "123" } next: endEscanear una tabla
El identificador de la acción es aws.dynamodb.scan.
Devuelve elementos de una tabla o un índice de DynamoDB escaneando toda la tabla, con filtrado opcional. Una única respuesta de escaneo está limitada a 100 KB por la Automatización de flujos de trabajo (el límite propio de DynamoDB es de 1 MB). Utilice limit y exclusiveStartKey para paginar tablas grandes.
Importante
La automatización de flujo de trabajo impone un límite de tamaño de salida de 100 KB por acción. aws.dynamodb.scan arroja una excepción de límite de tamaño de salida excedido cuando la respuesta supera este límite, aunque pueda estar dentro del propio límite de 1 MB por respuesta de DynamoDB. Utilice limit y exclusiveStartKey para paginar los resultados y mantenerse dentro de este límite.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS de la tabla objetivo. |
|
| Cadena | Requerido. Nombre de la tabla de DynamoDB. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Nombre de un índice secundario local o global para escanear en lugar de la tabla base. |
|
| Cadena | Opcional. Una condición que se aplica después de leer los elementos. Los elementos filtrados no se devuelven, pero aun así consumen capacidad de lectura. |
|
| Cadena | Opcional. Lista separada por comas de atributos a recuperar. Si se omite, se devuelven todos los atributos. |
|
| Mapa | Opcional. Token de sustitución para nombres de atributo en expresiones. |
|
| Mapa | Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel. |
|
| Cadena | Opcional. Atributos a devolver. Valores permitidos: |
|
| Entero | Opcional. Número máximo de elementos a evaluar (no necesariamente los elementos devueltos). Mínimo: 1. |
|
| Booleano | Opcional. Si es |
|
| Mapa | Opcional. Clave principal del primer elemento a evaluar. Utilice el |
|
| Entero | Opcional. Número total de segmentos para un escaneo paralelo. Debe usarse con |
|
| Entero | Opcional. ID de segmento basado en cero para un escaneo paralelo. Se debe utilizar con |
|
| Mapa | Opcional. Paso a través para cualquier campo |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Contiene |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: scan-dynamodb-tabledescription: Scan for active orders in DynamoDBsteps: - name: scanActiveOrders type: action action: aws.dynamodb.scan version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders filterExpression: '#s = :status' expressionAttributeNames: '#s': status expressionAttributeValues: ':status': { "S": "ACTIVE" } limit: 50 selectors: - name: items expression: '.response.Items' - name: lastKey expression: '.response.LastEvaluatedKey' next: endConsultar una tabla
El identificador de la acción es aws.dynamodb.query.
Devuelve elementos de una tabla o índice de DynamoDB que coinciden con una clave de partición, opcionalmente restringidos por una condición de clave de ordenación o una expresión de filtro. Más eficiente que el escaneo para las búsquedas basadas en claves.
Importante
La automatización de flujo de trabajo impone un límite de tamaño de salida de 100 KB por acción. aws.dynamodb.query arroja una excepción de límite de tamaño de salida excedido cuando la respuesta supera este límite, aunque pueda estar dentro del propio límite de 1 MB por respuesta de DynamoDB. Utilice limit y exclusiveStartKey para paginar los resultados y mantenerse dentro de este límite.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS de la tabla objetivo. |
|
| Cadena | Requerido. Nombre de la tabla de DynamoDB. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Nombre de un índice secundario local o global para consultar. |
|
| Cadena | Opcional. Condición en la clave de partición (obligatorio) y, opcionalmente, en la clave de clasificación. |
|
| Cadena | Opcional. Una condición que se aplica después de leer los elementos. No puede hacer referencia a atributos clave. Los elementos filtrados no se devuelven, pero siguen consumiendo capacidad de lectura. |
|
| Cadena | Opcional. Lista de atributos separados por comas para recuperar. |
|
| Mapa | Opcional. Token de sustitución para nombres de atributo en expresiones. |
|
| Mapa | Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel. |
|
| Cadena | Opcional. Atributos a devolver. Valores permitidos: |
|
| Entero | Opcional. Número máximo de elementos a evaluar. Mínimo: 1. |
|
| Booleano | Opcional. Si es |
|
| Booleano | Opcional. Si es |
|
| Mapa | Opcional. Clave principal del primer elemento a evaluar. Utilice el |
|
| Mapa | Opcional. Paso directo para cualquier campo |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Contiene |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: query-dynamodb-tabledescription: Query orders by customer IDsteps: - name: queryCustomerOrders type: action action: aws.dynamodb.query version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders indexName: customerId-index keyConditionExpression: 'customerId = :cid' expressionAttributeValues: ':cid': { "S": "cust-1" } selectors: - name: items expression: '.response.Items' next: endDescribir una tabla
El identificador de la acción es aws.dynamodb.describeTable.
Devuelve información de la tabla, incluido el estado, el esquema de clave principal, el rendimiento aprovisionado y (para tablas globales) el estado de la réplica.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS de la tabla objetivo. |
|
| Cadena | Requerido. Nombre de la tabla de DynamoDB. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Contiene |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: describe-dynamodb-tabledescription: Get the status and configuration of a DynamoDB tablesteps: - name: describeOrdersTable type: action action: aws.dynamodb.describeTable version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders selectors: - name: tableStatus expression: '.response.Table.TableStatus' next: endListar tablas
El identificador de la acción es aws.dynamodb.listTables.
Devuelve una lista de nombres de tablas de DynamoDB en la cuenta de AWS y región actuales. Los resultados están paginados —utilice exclusiveStartTableName con el LastEvaluatedTableName de una respuesta anterior para paginar los resultados.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS en la que enumerar las tablas. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Cadena | Opcional. Primer nombre de tabla a evaluar. Utilice el |
|
| Entero | Opcional. Número máximo de nombres de tabla a devolver (1-100). Predeterminado: 100. |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Contiene |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: list-dynamodb-tablesdescription: List all DynamoDB tables in a regionsteps: - name: listDynamoTables type: action action: aws.dynamodb.listTables version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 selectors: - name: tableNames expression: '.response.TableNames' next: endActualizar una tabla
El identificador de la acción es aws.dynamodb.updateTable.
Modifica la configuración de rendimiento aprovisionado, el modo de facturación, los índices secundarios globales, las regiones de replicación u otras configuraciones de una tabla de DynamoDB.
La siguiente tabla describe los campos de entrada para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Cadena | Requerido. Región de AWS de la tabla objetivo. |
|
| Cadena | Requerido. Nombre de la tabla de DynamoDB. |
|
| Cadena | Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS. |
|
| Cadena | Opcional. ID de clave de acceso de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Clave de acceso secreta de AWS. Páselo como un secreto. |
|
| Cadena | Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto. |
|
| Lista | Opcional. Matriz de definiciones de atributos para la tabla y los índices. Requerido al agregar un nuevo índice secundario global. |
|
| Cadena | Opcional. Controla cómo se cobra el rendimiento. Valores permitidos: |
|
| Mapa | Opcional. Requerido cuando |
|
| Lista | Opcional. Una o más acciones de actualización de índices secundarios globales (crear, actualizar o eliminar). Máximo de 20 GSI por tabla. |
|
| Mapa | Opcional. Configuración para DynamoDB Streams. |
|
| Mapa | Opcional. Configuración de cifrado del lado del servidor. |
|
| Booleano | Opcional. Habilitar o deshabilitar la protección contra eliminación en la tabla. |
|
| Mapa | Opcional. Paso directo para cualquier campo |
|
| Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe los campos de salida para esta acción.
Producción | Tipo | Ejemplo |
|---|---|---|
| Booleano |
|
| Objeto | Contiene |
| Cadena | Mensaje de error en caso de falla. |
Ejemplo
name: update-dynamodb-tabledescription: Switch a DynamoDB table to on-demand billingsteps: - name: setPayPerRequest type: action action: aws.dynamodb.updateTable version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders billingMode: PAY_PER_REQUEST selectors: - name: tableStatus expression: '.response.TableDescription.TableStatus' next: end