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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS da tabela de destino. |
|
| Corda | Obrigatório. Nome da tabela do DynamoDB. |
|
| 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. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Corda | Opcional. Uma condição que deve ser satisfeita para que o |
|
| Mapa | Opcional. Tokens de substituição para nomes de atributos em expressões. Use a sintaxe |
|
| Mapa | Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível. Use a sintaxe |
|
| Mapa | Opcional. Passagem para qualquer campo |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Resposta |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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: endObter 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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS da tabela de destino. |
|
| Corda | Obrigatório. Nome da tabela do DynamoDB. |
|
| Mapa | Obrigatório. A chave primária do item a ser recuperado, no formato AttributeValue de baixo nível. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Corda | Opcional. Lista de atributos separados por vírgula a serem recuperados. Se omitido, todos os atributos são retornados. |
|
| Mapa | Opcional. Tokens de substituição para nomes de atributos em expressões. Use a sintaxe |
|
| Boleano | Opcional. Se |
|
| Mapa | Opcional. Passagem para qualquer campo |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Contém |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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: endAtualizar 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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS da tabela de destino. |
|
| Corda | Obrigatório. Nome da tabela do DynamoDB. |
|
| Mapa | Obrigatório. A chave primária do item a ser atualizado, no formato AttributeValue de baixo nível. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Corda | Opcional. Define atributos para atualizar. Oferece suporte às ações |
|
| Corda | Opcional. Uma condição que deve ser satisfeita para que |
|
| Mapa | Opcional. Tokens de substituição para nomes de atributos em expressões. Use a sintaxe |
|
| Mapa | Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível. |
|
| Mapa | Opcional. Passagem para qualquer campo |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Contém |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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: endExcluir 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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS da tabela de destino. |
|
| Corda | Obrigatório. Nome da tabela do DynamoDB. |
|
| Mapa | Obrigatório. A chave primária do item a ser excluído, no formato AttributeValue de baixo nível. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Corda | Opcional. Uma condição que deve ser satisfeita para que |
|
| Mapa | Opcional. Tokens de substituição para nomes de atributos em expressões. |
|
| Mapa | Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível. |
|
| Mapa | Opcional. Passthrough para qualquer campo |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Contém |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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: endFazer 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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS da tabela de destino. |
|
| Corda | Obrigatório. Nome da tabela do DynamoDB. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Corda | Opcional. Nome de um índice secundário local ou global para varredura em vez da tabela base. |
|
| 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. |
|
| Corda | Opcional. Lista de atributos separados por vírgula a serem recuperados. Se omitido, todos os atributos são retornados. |
|
| Mapa | Opcional. Tokens de substituição para nomes de atributos em expressões. |
|
| Mapa | Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível. |
|
| Corda | Opcional. Atributos a serem retornados. Valores permitidos: |
|
| Inteiro | Opcional. Número máximo de itens a serem avaliados (não necessariamente itens retornados). Mínimo: 1. |
|
| Boleano | Opcional. Se |
|
| Mapa | Opcional. Chave primária do primeiro item a ser avaliado. Use o |
|
| Inteiro | Opcional. Número total de segmentos para um scan paralelo. Deve ser usado com |
|
| Inteiro | Opcional. ID de segmento baseado em zero para uma varredura paralela. Deve ser usado com |
|
| Mapa | Opcional. Passagem para qualquer campo |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Contém |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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 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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS da tabela de destino. |
|
| Corda | Obrigatório. Nome da tabela do DynamoDB. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Corda | Opcional. Nome de um índice secundário local ou global para consulta. |
|
| Corda | Opcional. Condição na chave de partição (obrigatória) e, opcionalmente, na chave de classificação. |
|
| 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. |
|
| Corda | Opcional. Lista de atributos separados por vírgula a serem recuperados. |
|
| Mapa | Opcional. Tokens de substituição para nomes de atributos em expressões. |
|
| Mapa | Opcional. Valores de substituição para expressões no formato AttributeValue de baixo nível. |
|
| Corda | Opcional. Atributos a serem retornados. Valores permitidos: |
|
| Inteiro | Opcional. Número máximo de itens a serem avaliados. Mínimo: 1. |
|
| Boleano | Opcional. Se |
|
| Boleano | Opcional. Se |
|
| Mapa | Opcional. Chave primária do primeiro item a ser avaliado. Use o |
|
| Mapa | Opcional. Repasse para qualquer campo |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Contém |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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: endDescrever 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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS da tabela de destino. |
|
| Corda | Obrigatório. Nome da tabela do DynamoDB. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Contém |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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 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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS para listar as tabelas. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Corda | Opcional. Primeiro nome de tabela a ser avaliado. Use o |
|
| Inteiro | Opcional. Número máximo de nomes de tabela a serem retornados (1–100). Padrão: 100. |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Contém |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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: endAtualizar 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 |
|---|---|---|---|
| Corda | Obrigatório. Região da AWS da tabela de destino. |
|
| Corda | Obrigatório. Nome da tabela do DynamoDB. |
|
| Corda | Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS. |
|
| Corda | Opcional. ID da chave de acesso da AWS. Passe como um segredo. |
|
| Corda | Opcional. Chave de acesso secreta da AWS. Passe como um segredo. |
|
| Corda | Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo. |
|
| Lista | Opcional. Matriz de definições de atributos para a tabela e os índices. Obrigatório ao adicionar um novo índice secundário global. |
|
| Corda | Opcional. Controla como as taxas de transferência são cobradas. Valores permitidos: |
|
| Mapa | Opcional. Obrigatório quando |
|
| 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. |
|
| Mapa | Opcional. Configurações para o DynamoDB Streams. |
|
| Mapa | Opcional. Configurações de criptografia do lado do servidor. |
|
| Boleano | Opcional. Habilitar ou desabilitar a proteção contra exclusão na tabela. |
|
| Mapa | Opcional. Passagem para qualquer campo |
|
| Lista | Opcional. Seletores JQ para extrair campos específicos da saída da ação. |
|
A tabela a seguir descreve os campos de saída para esta ação.
Saída | Tipo | Exemplo |
|---|---|---|
| Boleano |
|
| Objeto | Contém |
| Corda | Mensagem de erro em caso de falha. |
Exemplo
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