• /
  • EnglishEspañolFrançais日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Acciones de AWS DynamoDB

|View as Markdown (English)

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

region

Cadena

Requerido. Región de AWS de la tabla objetivo.

us-east-2

tableName

Cadena

Requerido. Nombre de la tabla de DynamoDB.

Orders

item

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.

{"id": {"S": "123"}, "status": {"S": "PLACED"}}

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

conditionExpression

Cadena

Opcional. Una condición que se debe cumplir para que PutItem se realice correctamente. Admite funciones (attribute_exists, attribute_not_exists, contains), operadores de comparación y operadores lógicos (AND, OR, NOT).

attribute_not_exists(id)

expressionAttributeNames

Mapa

Opcional. Tokens de sustitución para nombres de atributos en expresiones. Utilice la sintaxis #name para hacer referencia a palabras reservadas o caracteres especiales.

{"#n": "name"}

expressionAttributeValues

Mapa

Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel. Utilice la sintaxis :value.

{":id": {"S": "123"}}

parameters

Mapa

Opcional. Paso directo para cualquier campo put_item no modelado anteriormente. Los nombres de los campos deben usar PascalCase de boto3. Valores comunes: ReturnValues (NONE predeterminado | ALL_OLD), ReturnConsumedCapacity (NONE predeterminado | TOTAL | INDEXES), ReturnValuesOnConditionCheckFailure (NONE predeterminado | ALL_OLD). Consulte la referencia de la API de PutItem.

{"ReturnValues": "ALL_OLD"}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "attributes", "expression": ".response.Attributes"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Respuesta de put_item sin procesar. Contiene Attributes si ReturnValues se establece mediante parameters. Consulte la referencia de la API de PutItem.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: put-dynamodb-item
description: Write an order item to DynamoDB
steps:
- 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: end

Obtener 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

region

Cadena

Requerido. Región de AWS de la tabla objetivo.

us-east-2

tableName

Cadena

Requerido. Nombre de la tabla de DynamoDB.

Orders

key

Mapa

Requerido. La clave principal del elemento a recuperar, en formato AttributeValue de bajo nivel.

{"orderId": {"S": "123"}}

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

projectionExpression

Cadena

Opcional. Lista separada por comas de atributos a recuperar. Si se omite, se devuelven todos los atributos.

id, #n

expressionAttributeNames

Mapa

Opcional. Tokens de sustitución para nombres de atributos en expresiones. Utilice la sintaxis #name para hacer referencia a palabras reservadas o caracteres especiales.

{"#n": "name"}

consistentRead

Booleano

Opcional. Si es true, utiliza lecturas de consistencia alta. Predeterminado: false (consistencia eventual).

false

parameters

Mapa

Opcional. Traspaso para cualquier campo get_item no modelado anteriormente. Valor común: ReturnConsumedCapacity (NONE predeterminado | TOTAL | INDEXES). Consulte la referencia de la API de GetItem.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "item", "expression": ".response.Item"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Contiene Item si se encontró el elemento. Consulte la referencia de la API de GetItem.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: get-dynamodb-item
description: Retrieve an order item from DynamoDB by primary key
steps:
- 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: end

Actualizar 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

region

Cadena

Requerido. Región de AWS de la tabla objetivo.

us-east-2

tableName

Cadena

Requerido. Nombre de la tabla de DynamoDB.

Orders

key

Mapa

Requerido. La clave principal del elemento que se va a actualizar, en formato AttributeValue de bajo nivel.

{"orderId": {"S": "123"}}

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

updateExpression

Cadena

Opcional. Define los atributos a actualizar. Admite las acciones SET, REMOVE, ADD y DELETE.

SET #s = :status

conditionExpression

Cadena

Opcional. Una condición que debe cumplirse para que UpdateItem se realice correctamente.

attribute_exists(orderId)

expressionAttributeNames

Mapa

Opcional. Tokens de sustitución para nombres de atributos en expresiones. Utilice la sintaxis #name para hacer referencia a palabras reservadas o caracteres especiales.

{"#s": "status"}

expressionAttributeValues

Mapa

Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel.

{":status": {"S": "SHIPPED"}}

parameters

Mapa

Opcional. Paso directo para cualquier campo update_item no modelado anteriormente. Valor común: ReturnValues (NONE predeterminado | ALL_OLD | UPDATED_OLD | ALL_NEW | UPDATED_NEW). Consulte la referencia de la API de UpdateItem.

{"ReturnValues": "UPDATED_NEW"}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "attributes", "expression": ".response.Attributes"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Contiene Attributes si ReturnValues se establece a través de parameters. Consulte la referencia de la API de UpdateItem.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: update-dynamodb-item
description: Update the status of an order in DynamoDB
steps:
- 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: end

Eliminar 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

region

Cadena

Requerido. Región de AWS de la tabla objetivo.

us-east-2

tableName

Cadena

Requerido. Nombre de la tabla de DynamoDB.

Orders

key

Mapa

Requerido. La clave principal del elemento a eliminar, en formato AttributeValue de bajo nivel.

{"orderId": {"S": "123"}}

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

conditionExpression

Cadena

Opcional. Una condición que debe cumplirse para que DeleteItem se realice correctamente.

attribute_exists(orderId)

expressionAttributeNames

Mapa

Opcional. Token de sustitución para nombres de atributo en expresiones.

{"#n": "name"}

expressionAttributeValues

Mapa

Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel.

{":id": {"S": "123"}}

parameters

Mapa

Opcional. Paso directo para cualquier campo delete_item no modelado anteriormente. Valor común: ReturnValues (NONE predeterminado | ALL_OLD). Consulte la referencia de la API de DeleteItem.

{"ReturnValues": "ALL_OLD"}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "attributes", "expression": ".response.Attributes"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Contiene Attributes si ReturnValues se establece a través de parameters. Consulte la referencia de la API DeleteItem.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: delete-dynamodb-item
description: Delete an order item from DynamoDB
steps:
- 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: end

Escanear 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

region

Cadena

Requerido. Región de AWS de la tabla objetivo.

us-east-2

tableName

Cadena

Requerido. Nombre de la tabla de DynamoDB.

Orders

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

indexName

Cadena

Opcional. Nombre de un índice secundario local o global para escanear en lugar de la tabla base.

my-gsi

filterExpression

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.

#s = :status

projectionExpression

Cadena

Opcional. Lista separada por comas de atributos a recuperar. Si se omite, se devuelven todos los atributos.

id, #n

expressionAttributeNames

Mapa

Opcional. Token de sustitución para nombres de atributo en expresiones.

{"#s": "status"}

expressionAttributeValues

Mapa

Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel.

{":status": {"S": "ACTIVE"}}

select

Cadena

Opcional. Atributos a devolver. Valores permitidos: ALL_ATTRIBUTES, ALL_PROJECTED_ATTRIBUTES, SPECIFIC_ATTRIBUTES, COUNT.

ALL_ATTRIBUTES

limit

Entero

Opcional. Número máximo de elementos a evaluar (no necesariamente los elementos devueltos). Mínimo: 1.

100

consistentRead

Booleano

Opcional. Si es true, utiliza lecturas de consistencia alta. No se admite en índices secundarios globales. Por defecto: false.

false

exclusiveStartKey

Mapa

Opcional. Clave principal del primer elemento a evaluar. Utilice el LastEvaluatedKey de un escaneo anterior para paginar.

{"orderId": {"S": "123"}}

totalSegments

Entero

Opcional. Número total de segmentos para un escaneo paralelo. Debe usarse con segment. Rango permitido: 1-1 000 000.

4

segment

Entero

Opcional. ID de segmento basado en cero para un escaneo paralelo. Se debe utilizar con totalSegments.

0

parameters

Mapa

Opcional. Paso a través para cualquier campo scan no modelado anteriormente. Consulte la referencia de la API de Scan.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "items", "expression": ".response.Items"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Contiene Items (elementos coincidentes) y LastEvaluatedKey (presente cuando existen más páginas). Consulte la referencia de la API Scan.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: scan-dynamodb-table
description: Scan for active orders in DynamoDB
steps:
- 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: end

Consultar 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

region

Cadena

Requerido. Región de AWS de la tabla objetivo.

us-east-2

tableName

Cadena

Requerido. Nombre de la tabla de DynamoDB.

Orders

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

indexName

Cadena

Opcional. Nombre de un índice secundario local o global para consultar.

customerId-index

keyConditionExpression

Cadena

Opcional. Condición en la clave de partición (obligatorio) y, opcionalmente, en la clave de clasificación.

customerId = :cid

filterExpression

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.

#s = :status

projectionExpression

Cadena

Opcional. Lista de atributos separados por comas para recuperar.

id, #n

expressionAttributeNames

Mapa

Opcional. Token de sustitución para nombres de atributo en expresiones.

{"#s": "status"}

expressionAttributeValues

Mapa

Opcional. Valores de sustitución para expresiones en formato AttributeValue de bajo nivel.

{":cid": {"S": "cust-1"}}

select

Cadena

Opcional. Atributos a devolver. Valores permitidos: ALL_ATTRIBUTES, ALL_PROJECTED_ATTRIBUTES, SPECIFIC_ATTRIBUTES, COUNT.

ALL_ATTRIBUTES

limit

Entero

Opcional. Número máximo de elementos a evaluar. Mínimo: 1.

100

scanIndexForward

Booleano

Opcional. Si es true (predeterminado), devuelve los resultados en orden ascendente de la clave de ordenación. Si es false, devuelve en orden descendente.

true

consistentRead

Booleano

Opcional. Si es true, utiliza lecturas de consistencia alta. No se admite en índices secundarios globales. Por defecto: false.

false

exclusiveStartKey

Mapa

Opcional. Clave principal del primer elemento a evaluar. Utilice el LastEvaluatedKey de una consulta anterior para paginar.

{"orderId": {"S": "123"}}

parameters

Mapa

Opcional. Paso directo para cualquier campo query no modelado anteriormente. Consulte la referencia de la API de consulta.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "items", "expression": ".response.Items"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Contiene Items (elementos coincidentes) y LastEvaluatedKey (presente cuando existen más páginas). Consulte la referencia de la API de consulta.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: query-dynamodb-table
description: Query orders by customer ID
steps:
- 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: end

Describir 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

region

Cadena

Requerido. Región de AWS de la tabla objetivo.

us-east-2

tableName

Cadena

Requerido. Nombre de la tabla de DynamoDB.

Orders

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "tableStatus", "expression": ".response.Table.TableStatus"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Contiene Table con TableStatus, KeySchema, ProvisionedThroughput y Replicas para tablas globales. Consulte la referencia de la API de DescribeTable.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: describe-dynamodb-table
description: Get the status and configuration of a DynamoDB table
steps:
- 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: end

Listar 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

region

Cadena

Requerido. Región de AWS en la que enumerar las tablas.

us-east-2

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

exclusiveStartTableName

Cadena

Opcional. Primer nombre de tabla a evaluar. Utilice el LastEvaluatedTableName de una respuesta anterior para paginar.

my-table

limit

Entero

Opcional. Número máximo de nombres de tabla a devolver (1-100). Predeterminado: 100.

50

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "tableNames", "expression": ".response.TableNames"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Contiene TableNames (lista de cadenas de nombres de tabla) y LastEvaluatedTableName cuando existen más páginas. Consulte la referencia de la API de ListTables.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: list-dynamodb-tables
description: List all DynamoDB tables in a region
steps:
- 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: end

Actualizar 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

region

Cadena

Requerido. Región de AWS de la tabla objetivo.

us-east-2

tableName

Cadena

Requerido. Nombre de la tabla de DynamoDB.

Orders

awsRoleArn

Cadena

Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional. ID de clave de acceso de AWS. Páselo como un secreto.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.

${{ :secrets:awsSessionToken }}

attributeDefinitions

Lista

Opcional. Matriz de definiciones de atributos para la tabla y los índices. Requerido al agregar un nuevo índice secundario global.

[{"AttributeName": "id", "AttributeType": "S"}]

billingMode

Cadena

Opcional. Controla cómo se cobra el rendimiento. Valores permitidos: PROVISIONED, PAY_PER_REQUEST.

PAY_PER_REQUEST

provisionedThroughput

Mapa

Opcional. Requerido cuando billingMode es PROVISIONED. No se puede establecer cuando billingMode es PAY_PER_REQUEST.

{"ReadCapacityUnits": 5, "WriteCapacityUnits": 5}

globalSecondaryIndexUpdates

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.

[{"Update": {"IndexName": "my-gsi", "ProvisionedThroughput": {"ReadCapacityUnits": 5, "WriteCapacityUnits": 5}}}]

streamSpecification

Mapa

Opcional. Configuración para DynamoDB Streams.

{"StreamEnabled": true, "StreamViewType": "NEW_AND_OLD_IMAGES"}

sseSpecification

Mapa

Opcional. Configuración de cifrado del lado del servidor.

{"Enabled": true, "SSEType": "KMS"}

deletionProtectionEnabled

Booleano

Opcional. Habilitar o deshabilitar la protección contra eliminación en la tabla.

true

parameters

Mapa

Opcional. Paso directo para cualquier campo update_table no modelado anteriormente. Valores comunes: ReplicaUpdates (agregar/eliminar réplicas de tablas globales), TableClass (STANDARD | STANDARD_INFREQUENT_ACCESS). Consulte la referencia de la API de UpdateTable.

{"ReplicaUpdates": [{"Create": {"RegionName": "eu-west-1"}}]}

selectors

Lista

Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "tableStatus", "expression": ".response.TableDescription.TableStatus"}]

La siguiente tabla describe los campos de salida para esta acción.

Producción

Tipo

Ejemplo

success

Booleano

true o false

response

Objeto

Contiene TableDescription. Consulte la referencia de la API de UpdateTable.

errorMessage

Cadena

Mensaje de error en caso de falla.

Ejemplo

name: update-dynamodb-table
description: Switch a DynamoDB table to on-demand billing
steps:
- 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
Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.