• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Ações do AWS DynamoDB

|View as Markdown (English)

Esta página fornece uma referência para as ações do AWS DynamoDB disponíveis no catálogo de ações de automação de fluxo de trabalho. Você pode usar essas ações para ler, gravar, atualizar e excluir itens em tabelas do DynamoDB e para inspecionar ou modificar a configuração da tabela diretamente de uma definição de fluxo de trabalho.

Pré-requisitos

Para pré-requisitos e configuração de credenciais, consulte Configurar credenciais da AWS.

Todas as ações do DynamoDB aceitam as mesmas entradas de autenticação. Use awsRoleArn (recomendado) ou o par de chaves de acesso.

Inserir um item

O identificador da ação é aws.dynamodb.putItem.

Cria um novo item ou substitui um item existente em uma tabela do DynamoDB. Usa o formato de baixo nível AttributeValue do DynamoDB para o mapa item.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS da tabela de destino.

us-east-2

tableName

Corda

Obrigatório. Nome da tabela do DynamoDB.

Orders

item

Mapa

Obrigatório. Um mapa de pares de nome/valor de atributo no formato AttributeValue de baixo nível do DynamoDB. Apenas os atributos de chave primária são obrigatórios; outros atributos são opcionais.

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

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

conditionExpression

Corda

Opcional. Uma condição que deve ser satisfeita para que o PutItem seja bem-sucedido. Suporta funções (attribute_exists, attribute_not_exists, contains), operadores de comparação e operadores lógicos (AND, OR, NOT).

attribute_not_exists(id)

expressionAttributeNames

Mapa

Opcional. Tokens de substituição para nomes de atributos em expressões. Use a sintaxe #name para referenciar palavras reservadas ou caracteres especiais.

{"#n": "name"}

expressionAttributeValues

Mapa

Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível. Use a sintaxe :value.

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

parameters

Mapa

Opcional. Passagem para qualquer campo put_item não modelado acima. Os nomes dos campos devem usar o PascalCase do boto3. Valores comuns: ReturnValues (NONE padrão | ALL_OLD), ReturnConsumedCapacity (NONE padrão | TOTAL | INDEXES), ReturnValuesOnConditionCheckFailure (NONE padrão | ALL_OLD). Consulte a referência da API PutItem.

{"ReturnValues": "ALL_OLD"}

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Resposta put_item bruta. Contém Attributes se ReturnValues estiver definido via parameters. Consulte a referência da API PutItem.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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

Obter um item

O identificador da ação é aws.dynamodb.getItem.

Recupera um único item de uma tabela do DynamoDB por sua chave primária.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS da tabela de destino.

us-east-2

tableName

Corda

Obrigatório. Nome da tabela do DynamoDB.

Orders

key

Mapa

Obrigatório. A chave primária do item a ser recuperado, no formato AttributeValue de baixo nível.

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

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

projectionExpression

Corda

Opcional. Lista de atributos separados por vírgula a serem recuperados. Se omitido, todos os atributos são retornados.

id, #n

expressionAttributeNames

Mapa

Opcional. Tokens de substituição para nomes de atributos em expressões. Use a sintaxe #name para referenciar palavras reservadas ou caracteres especiais.

{"#n": "name"}

consistentRead

Boleano

Opcional. Se true, usa leituras fortemente consistentes. Padrão: false (eventualmente consistente).

false

parameters

Mapa

Opcional. Passagem para qualquer campo get_item não modelado acima. Valor comum: ReturnConsumedCapacity (NONE padrão | TOTAL | INDEXES). Consulte a referência da API GetItem.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Contém Item se o item foi encontrado. Consulte a referência da API GetItem.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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

Atualizar um item

O identificador da ação é aws.dynamodb.updateItem.

Edita os atributos de um item existente ou adiciona um novo item se ele ainda não existir.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS da tabela de destino.

us-east-2

tableName

Corda

Obrigatório. Nome da tabela do DynamoDB.

Orders

key

Mapa

Obrigatório. A chave primária do item a ser atualizado, no formato AttributeValue de baixo nível.

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

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

updateExpression

Corda

Opcional. Define atributos para atualizar. Oferece suporte às ações SET, REMOVE, ADD e DELETE.

SET #s = :status

conditionExpression

Corda

Opcional. Uma condição que deve ser satisfeita para que UpdateItem seja bem-sucedido.

attribute_exists(orderId)

expressionAttributeNames

Mapa

Opcional. Tokens de substituição para nomes de atributos em expressões. Use a sintaxe #name para referenciar palavras reservadas ou caracteres especiais.

{"#s": "status"}

expressionAttributeValues

Mapa

Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível.

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

parameters

Mapa

Opcional. Passagem para qualquer campo update_item não modelado acima. Valor comum: ReturnValues (NONE padrão | ALL_OLD | UPDATED_OLD | ALL_NEW | UPDATED_NEW). Consulte a referência da API UpdateItem.

{"ReturnValues": "UPDATED_NEW"}

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Contém Attributes se ReturnValues for definido via parameters. Consulte a referência da API UpdateItem.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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

Excluir um item

O identificador da ação é aws.dynamodb.deleteItem.

Exclui um único item de uma tabela do DynamoDB por sua chave primária.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS da tabela de destino.

us-east-2

tableName

Corda

Obrigatório. Nome da tabela do DynamoDB.

Orders

key

Mapa

Obrigatório. A chave primária do item a ser excluído, no formato AttributeValue de baixo nível.

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

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

conditionExpression

Corda

Opcional. Uma condição que deve ser satisfeita para que DeleteItem seja bem-sucedido.

attribute_exists(orderId)

expressionAttributeNames

Mapa

Opcional. Tokens de substituição para nomes de atributos em expressões.

{"#n": "name"}

expressionAttributeValues

Mapa

Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível.

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

parameters

Mapa

Opcional. Passthrough para qualquer campo delete_item não modelado acima. Valor comum: ReturnValues (padrão NONE | ALL_OLD). Consulte a referência da API DeleteItem.

{"ReturnValues": "ALL_OLD"}

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Contém Attributes se ReturnValues estiver definido via parameters. Consulte a referência da API DeleteItem.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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

Fazer a varredura de uma tabela

O identificador da ação é aws.dynamodb.scan.

Retorna itens de uma tabela ou índice do DynamoDB fazendo a varredura de toda a tabela, com filtragem opcional. Uma única resposta de varredura é limitada a 100 KB pela Automação de fluxo de trabalho (o limite do próprio DynamoDB é de 1 MB). Utilize limit e exclusiveStartKey para paginar por tabelas grandes.

Importante

A Automação de fluxo de trabalho impõe um limite de tamanho de saída de 100 KB por ação. aws.dynamodb.scan lança uma exceção de limite de tamanho de saída excedido quando a resposta ultrapassa esse limite, mesmo que possa estar dentro do próprio limite de 1 MB por resposta do DynamoDB. Use limit e exclusiveStartKey para paginar os resultados e permanecer dentro desse limite.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS da tabela de destino.

us-east-2

tableName

Corda

Obrigatório. Nome da tabela do DynamoDB.

Orders

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

indexName

Corda

Opcional. Nome de um índice secundário local ou global para varredura em vez da tabela base.

my-gsi

filterExpression

Corda

Opcional. Uma condição aplicada após a leitura dos itens. Itens filtrados não são retornados, mas ainda consomem capacidade de leitura.

#s = :status

projectionExpression

Corda

Opcional. Lista de atributos separados por vírgula a serem recuperados. Se omitido, todos os atributos são retornados.

id, #n

expressionAttributeNames

Mapa

Opcional. Tokens de substituição para nomes de atributos em expressões.

{"#s": "status"}

expressionAttributeValues

Mapa

Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível.

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

select

Corda

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

ALL_ATTRIBUTES

limit

Inteiro

Opcional. Número máximo de itens a serem avaliados (não necessariamente itens retornados). Mínimo: 1.

100

consistentRead

Boleano

Opcional. Se true, usa leituras fortemente consistentes. Não compatível com índices secundários globais. Padrão: false.

false

exclusiveStartKey

Mapa

Opcional. Chave primária do primeiro item a ser avaliado. Use o LastEvaluatedKey de uma varredura anterior para paginar.

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

totalSegments

Inteiro

Opcional. Número total de segmentos para um scan paralelo. Deve ser usado com segment. Intervalo permitido: 1–1.000.000.

4

segment

Inteiro

Opcional. ID de segmento baseado em zero para uma varredura paralela. Deve ser usado com totalSegments.

0

parameters

Mapa

Opcional. Passagem para qualquer campo scan não modelado acima. Consulte a referência da API Scan.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Contém Items (itens correspondentes) e LastEvaluatedKey (presente quando existem mais páginas). Consulte a referência da API Scan.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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 uma tabela

O identificador da ação é aws.dynamodb.query.

Retorna itens de uma tabela ou índice do DynamoDB que correspondem a uma chave de partição, opcionalmente restritos por uma condição de chave de classificação ou expressão de filtro. Mais eficiente que o scan para pesquisas baseadas em chave.

Importante

A Automação de fluxo de trabalho impõe um limite de tamanho de saída de 100 KB por ação. aws.dynamodb.query lança uma exceção de limite de tamanho de saída excedido quando a resposta ultrapassa esse limite, mesmo que possa estar dentro do próprio limite de 1 MB por resposta do DynamoDB. Use limit e exclusiveStartKey para paginar os resultados e permanecer dentro desse limite.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS da tabela de destino.

us-east-2

tableName

Corda

Obrigatório. Nome da tabela do DynamoDB.

Orders

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

indexName

Corda

Opcional. Nome de um índice secundário local ou global para consulta.

customerId-index

keyConditionExpression

Corda

Opcional. Condição na chave de partição (obrigatória) e, opcionalmente, na chave de classificação.

customerId = :cid

filterExpression

Corda

Opcional. Uma condição aplicada após a leitura dos itens. Não é possível referenciar atributos de chave. Os itens filtrados não são retornados, mas ainda consomem capacidade de leitura.

#s = :status

projectionExpression

Corda

Opcional. Lista de atributos separados por vírgula a serem recuperados.

id, #n

expressionAttributeNames

Mapa

Opcional. Tokens de substituição para nomes de atributos em expressões.

{"#s": "status"}

expressionAttributeValues

Mapa

Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível.

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

select

Corda

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

ALL_ATTRIBUTES

limit

Inteiro

Opcional. Número máximo de itens a serem avaliados. Mínimo: 1.

100

scanIndexForward

Boleano

Opcional. Se true (padrão), retorna os resultados em ordem crescente da chave de classificação. Se false, retorna em ordem decrescente.

true

consistentRead

Boleano

Opcional. Se true, usa leituras fortemente consistentes. Não compatível com índices secundários globais. Padrão: false.

false

exclusiveStartKey

Mapa

Opcional. Chave primária do primeiro item a ser avaliado. Use o LastEvaluatedKey de uma consulta anterior para paginar.

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

parameters

Mapa

Opcional. Repasse para qualquer campo query não modelado acima. Consulte a referência da API de consulta.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Contém Items (itens correspondentes) e LastEvaluatedKey (presente quando existem mais páginas). Consulte a referência da API de consulta.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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

Descrever uma tabela

O identificador da ação é aws.dynamodb.describeTable.

Retorna informações da tabela, incluindo status, esquema de chave primária, taxas de transferência provisionadas e (para tabelas globais) status da réplica.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS da tabela de destino.

us-east-2

tableName

Corda

Obrigatório. Nome da tabela do DynamoDB.

Orders

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Contém Table com TableStatus, KeySchema, ProvisionedThroughput e Replicas para tabelas globais. Consulte a referência da API DescribeTable.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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 tabelas

O identificador da ação é aws.dynamodb.listTables.

Retorna uma lista de nomes de tabelas do DynamoDB na conta da AWS e região atuais. Os resultados são paginados — use exclusiveStartTableName com o LastEvaluatedTableName de uma resposta anterior para percorrer os resultados.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS para listar as tabelas.

us-east-2

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

exclusiveStartTableName

Corda

Opcional. Primeiro nome de tabela a ser avaliado. Use o LastEvaluatedTableName de uma resposta anterior para paginar.

my-table

limit

Inteiro

Opcional. Número máximo de nomes de tabela a serem retornados (1–100). Padrão: 100.

50

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Contém TableNames (lista de strings de nomes de tabela) e LastEvaluatedTableName quando há mais páginas. Consulte a referência da API ListTables.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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

Atualizar uma tabela

O identificador da ação é aws.dynamodb.updateTable.

Modifica as configurações de taxas de transferência provisionadas, o modo de faturamento, os índices secundários globais, as regiões de replicação ou outras configurações de uma tabela do DynamoDB.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada

Tipo

Descrição

Exemplo

region

Corda

Obrigatório. Região da AWS da tabela de destino.

us-east-2

tableName

Corda

Obrigatório. Nome da tabela do DynamoDB.

Orders

awsRoleArn

Corda

Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.

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

awsAccessKeyId

Corda

Opcional. ID da chave de acesso da AWS. Passe como um segredo.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Corda

Opcional. Chave de acesso secreta da AWS. Passe como um segredo.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Corda

Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.

${{ :secrets:awsSessionToken }}

attributeDefinitions

Lista

Opcional. Matriz de definições de atributos para a tabela e os índices. Obrigatório ao adicionar um novo índice secundário global.

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

billingMode

Corda

Opcional. Controla como as taxas de transferência são cobradas. Valores permitidos: PROVISIONED, PAY_PER_REQUEST.

PAY_PER_REQUEST

provisionedThroughput

Mapa

Opcional. Obrigatório quando billingMode for PROVISIONED. Não pode ser definido quando billingMode for PAY_PER_REQUEST.

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

globalSecondaryIndexUpdates

Lista

Opcional. Uma ou mais ações de atualização de índice secundário global (criar, atualizar ou excluir). Máximo de 20 GSIs por tabela.

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

streamSpecification

Mapa

Opcional. Configurações para o DynamoDB Streams.

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

sseSpecification

Mapa

Opcional. Configurações de criptografia do lado do servidor.

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

deletionProtectionEnabled

Boleano

Opcional. Habilitar ou desabilitar a proteção contra exclusão na tabela.

true

parameters

Mapa

Opcional. Passagem para qualquer campo update_table não modelado acima. Valores comuns: ReplicaUpdates (adicionar/remover réplicas de tabela global), TableClass (STANDARD | STANDARD_INFREQUENT_ACCESS). Consulte a referência da API UpdateTable.

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

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

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

A tabela a seguir descreve os campos de saída para esta ação.

Saída

Tipo

Exemplo

success

Boleano

true ou false

response

Objeto

Contém TableDescription. Consulte a referência da API UpdateTable.

errorMessage

Corda

Mensagem de erro em caso de falha.

Exemplo

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.