Ações, recursos e chaves de condição do Amazon DynamoDB - Referência de autorização do serviço

Ações, recursos e chaves de condição do Amazon DynamoDB

O Amazon DynamoDB (prefixo do serviço: dynamodb) fornece os seguintes recursos, ações e chaves de contexto de condição específicos ao serviço para uso em políticas de permissão do IAM.

Referências:

Ações definidas pelo Amazon DynamoDB

Você pode especificar as seguintes ações no elemento Action de uma declaração de política do IAM. Use políticas para conceder permissões para executar uma operação na AWS. Quando usa uma ação em uma política, você geralmente permite ou nega acesso à operação da API ou ao comando da CLI com o mesmo nome. No entanto, em alguns casos, uma única ação controla o acesso a mais de uma operação. Como alternativa, algumas operações exigem várias ações diferentes.

A coluna Resource types (Tipos de recursos) indica se cada ação é compatível com permissões no nível do recurso. Se não houver valor para essa coluna, você deverá especificar todos os recursos ("*") no elemento Resource de sua declaração de política. Se a coluna incluir um tipo de recurso, você poderá especificar um ARN desse tipo em uma declaração com essa ação. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você especificar um ARN de permissão no nível do recurso em uma instrução que esteja usando essa ação, ele deverá ser desse tipo. Algumas ações oferecem suporte a vários tipos de recursos. Se o tipo de recurso for opcional (não indicado como obrigatório), você poderá optar por usar um, mas não o outro.

Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de ações.

Ações Descrição Nível de acesso Tipos de recursos (*necessários) Chaves de condição Ações dependentes
BatchGetItem Concede permissão para retornar os atributos de um ou mais itens de uma ou mais tabelas Read

table*

dynamodb:Attributes

dynamodb:LeadingKeys

dynamodb:ReturnConsumedCapacity

dynamodb:Select

BatchWriteItem Concede permissão para adicionar ou excluir múltiplos itens em uma ou mais tabelas Write

table*

dynamodb:Attributes

dynamodb:LeadingKeys

dynamodb:ReturnConsumedCapacity

ConditionCheckItem Concede permissão para a operação ConditionCheckItem verificar a existência de um conjunto de atributos para o item com a chave primária determinada Read

table*

dynamodb:Attributes

dynamodb:LeadingKeys

dynamodb:ReturnConsumedCapacity

dynamodb:ReturnValues

CreateBackup Concede permissão para criar um backup de uma tabela existente Write

table*

CreateGlobalTable Concede permissão para criar uma tabela global a partir de uma tabela existente Write

global-table*

table*

CreateTable Concede permissão para a operação CreateTable adicionar uma nova tabela a sua conta Write

table*

CreateTableReplica Concede permissão para adicionar uma nova tabela de réplica Write

table*

DeleteBackup Concede permissão para excluir um backup existente de uma tabela Write

backup*

DeleteItem Concede permissão para excluir um único item em uma tabela por chave primária Write

table*

dynamodb:Attributes

dynamodb:EnclosingOperation

dynamodb:LeadingKeys

dynamodb:ReturnConsumedCapacity

dynamodb:ReturnValues

DeleteTable Concede permissão para a operação DeleteTable que exclui uma tabela e todos os seus itens Write

table*

DeleteTableReplica Concede permissão para excluir uma tabela de réplica e todos os seus itens Write

table*

DescribeBackup Concede permissão para descrever um backup existente de uma tabela Read

backup*

DescribeContinuousBackups Concede permissão para verificar o status das configurações de restauração do backup na tabela especificada Read

table*

DescribeContributorInsights Concede permissão para descrever o status do contributor insights e os detalhes relacionados de determinada tabela ou índice secundário global Read

table*

index

DescribeExport Concede permissão para descrever uma exportação de uma tabela existente Read

export*

DescribeGlobalTable Concede permissão para retornar informações sobre o agente global especificado Read

global-table*

DescribeGlobalTableSettings Concede permissão para retornar informações de configuração sobre o agente global especificado Read

global-table*

DescribeKinesisStreamingDestination Concede permissão para conceder permissão para descrever o status da transmissão do Kinesis e os detalhes relacionados de uma determinada tabela Read

table*

DescribeLimits Concede permissão para retornar os limites atuais da capacidade provisionada para a Conta da AWS em uma região, tanto para a região como um todo quanto para qualquer tabela do DynamoDB que você tenha criado nela Read
DescribeReservedCapacity Concede permissão para descrever uma ou mais da Capacidade Reservada adquirida Read
DescribeReservedCapacityOfferings Concede permissão para descrever as ofertas de Capacidade Reservada disponíveis para compra Read
DescribeStream Concede permissão para retornar informações sobre uma transmissão, incluindo o status atual da transmissão, o nome do recurso da Amazon (ARN), a composição de seus estilhaços e sua tabela correspondente do DynamoDB Read

stream*

DescribeTable Concede permissão para retornar informações sobre a tarefa Read

table*

DescribeTableReplicaAutoScaling Concede permissão para descrever as configurações de Auto Scaling em todas as réplicas da tabela global Read

table*

DescribeTimeToLive Concede permissão para fornecer uma descrição do status do tempo de vida (TTL) na tabela especificada Read

table*

DisableKinesisStreamingDestination Concede permissão para conceder permissão para interromper a replicação da tabela do DynamoDB para o fluxo de dados do Kinesis Write

table*

EnableKinesisStreamingDestination Concede permissão para conceder permissão para iniciar a replicação de dados de tabela para o fluxo de dados do Kinesis especificado em um carimbo de data/hora escolhido durante o fluxo de trabalho de habilitação Write

table*

ExportTableToPointInTime Concede permissão para iniciar uma exportação de uma tabela do DynamoDB para o S3 Write

table*

GetItem Concede permissão para a operação GetItem retornar um conjunto de atributos do item com a chave primária fornecida Read

table*

dynamodb:Attributes

dynamodb:EnclosingOperation

dynamodb:LeadingKeys

dynamodb:ReturnConsumedCapacity

dynamodb:Select

GetRecords Concede permissão para recuperar os registros da transmissão em um determinado fragmento Read

stream*

GetShardIterator Concede permissão para retornar um iterador de fragmento Read

stream*

ListBackups Concede permissão para listar os backups associados à conta e ao endpoint List
ListContributorInsights Concede permissão para listar o ContributorInsightsSummary para todas as tabelas e índices secundários globais associados à conta atual e ao endpoint List
ListExports Concede permissão para listar as exportações associadas à conta e ao endpoint List
ListGlobalTables Concede permissão para listar todas as tabelas globais que têm uma réplica na região especificada List
ListStreams Concede permissão para retorna uma matriz de ARNs de transmissões associadas à conta e ao endpoint atuais Read
ListTables Concede permissão para retornar uma matriz de nomes de tabela associados à conta e ao endpoint atuais List
ListTagsOfResource Concede permissão para listar todas as etiquetas em um recurso do Amazon DynamoDB Read

table*

PartiQLDelete Concede permissão para excluir um único item em uma tabela por chave primária Write

table*

dynamodb:Attributes

dynamodb:EnclosingOperation

dynamodb:LeadingKeys

dynamodb:ReturnValues

PartiQLInsert Concede permissão para criar um novo item, se um item com a mesma chave primária não existir na tabela Write

table*

dynamodb:Attributes

dynamodb:EnclosingOperation

dynamodb:LeadingKeys

PartiQLSelect Concede permissão para ler um conjunto de atributos para itens de uma tabela ou índice Read

table*

index

dynamodb:Attributes

dynamodb:EnclosingOperation

dynamodb:FullTableScan

dynamodb:LeadingKeys

dynamodb:Select

PartiQLUpdate Concede permissão para editar os atributos de um item existente Write

table*

dynamodb:Attributes

dynamodb:EnclosingOperation

dynamodb:LeadingKeys

dynamodb:ReturnValues

PurchaseReservedCapacityOfferings Concede permissão para comprar capacidade reservada para uso com sua conta Write
PutItem Concede permissão para criar um novo item ou substituir um item antigo por um novo Write

table*

dynamodb:Attributes

dynamodb:EnclosingOperation

dynamodb:LeadingKeys

dynamodb:ReturnConsumedCapacity

dynamodb:ReturnValues

Query Concede permissão para usar a chave primária de uma tabela ou de um índice secundário para acessar diretamente os itens dessa tabela ou índice Read

table*

index

dynamodb:Attributes

dynamodb:LeadingKeys

dynamodb:ReturnConsumedCapacity

dynamodb:ReturnValues

dynamodb:Select

RestoreTableFromAwsBackup Concede permissão para criar uma nova tabela a partir do ponto de recuperação AWS Backup Write

table*

RestoreTableFromBackup Concede permissão para criar uma nova tabela de um backup existente Write

backup*

table*

RestoreTableToPointInTime Concede permissão para restaurar uma tabela para um momento Write

table*

Scan Concede permissão para retornar um ou mais itens e atributos de itens acessando cada item em uma tabela ou um índice secundário Read

table*

index

dynamodb:Attributes

dynamodb:ReturnConsumedCapacity

dynamodb:ReturnValues

dynamodb:Select

StartAwsBackupJob Concede permissão para criar um backup em AWS Backup com recursos avançados habilitados Write

table*

TagResource Concede permissão para associar um conjunto de etiquetas com um recurso do Amazon DynamoDB Marcação

table*

UntagResource Concede permissão para remover a associação de etiquetas de um recurso do Amazon DynamoDB Marcação

table*

UpdateContinuousBackups Concede permissão para habilitar ou desabilitar backups contínuos Write

table*

UpdateContributorInsights Concede permissão para atualizar o status do contributor insights para uma tabela ou índice secundário global específico Write

table*

index

UpdateGlobalTable Concede permissão para adicionar ou remover réplicas na tabela global especificada Write

global-table*

table*

UpdateGlobalTableSettings Concede permissão para atualizar configurações do conjunto de tarefas especificado Write

global-table*

table*

UpdateItem Concede permissão para editar os atributos de um item existente, ou adiciona um novo item à tabela, se ele ainda não existir Write

table*

dynamodb:Attributes

dynamodb:EnclosingOperation

dynamodb:LeadingKeys

dynamodb:ReturnConsumedCapacity

dynamodb:ReturnValues

UpdateTable Concede permissão para modificar as configurações de throughput provisionada, índices secundários globais ou as configurações do DynamoDB Streams para uma determinada tabela Write

table*

UpdateTableReplicaAutoScaling Concede permissão para atualizar as configurações de Auto Scaling na tabela-réplica Write

table*

UpdateTimeToLive Concede permissão para habilitar ou desabilitar o TTL para a tabela especificada Write

table*

Tipos de recursos definidos pelo Amazon DynamoDB

Os seguintes tipos de recursos são definidos por este serviço e podem ser usados no elemento Resource de declarações de políticas de permissão do IAM. Cada ação na Tabela de ações identifica os tipos de recursos que podem ser especificados com essa ação. Um tipo de recurso também pode definir quais chaves de condição você pode incluir em uma política. Essas chaves são exibidas na última coluna da tabela. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.

Tipos de recursos ARN Chaves de condição
index arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/index/${IndexName}
stream arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/stream/${StreamLabel}
table arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}
backup arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/backup/${BackupName}
export arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}/export/${ExportName}
global-table arn:${Partition}:dynamodb::${Account}:global-table/${GlobalTableName}

Chaves de condição do Amazon DynamoDB

O Amazon DynamoDB define as seguintes chaves de condição que podem ser usadas no elemento Condition de uma política do IAM. É possível usar essas chaves para refinar ainda mais as condições sob as quais a declaração de política se aplica. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de chaves de condição.

Para visualizar as chaves de condição globais disponíveis para todos os serviços, consulte Chaves de condição globais disponíveis.

nota

Para obter informações sobre como usar chaves de contexto para refinar o acesso ao DynamoDB usando uma política do IAM, consulte Uso de condições de política do IAM para controle de acesso refinado no Guia do desenvolvedor do Amazon DynamoDB.

Chaves de condição Descrição Type
dynamodb:Attributes Filtrar com base nos nomes dos atributos (campo ou coluna) da tabela String
dynamodb:EnclosingOperation Usado para bloquear chamadas de APIs de transações e permitir as chamadas de APIs de não transação, e vice-versa String
dynamodb:FullTableScan Usado para bloquear a varredura completa da tabela Bool
dynamodb:LeadingKeys Filtra com base na chave de partição da tabela String
dynamodb:ReturnConsumedCapacity Filtrar com base no parâmetro ReturnConsumedCapacity de uma solicitação. Contém "TOTAL" ou "NONE" String
dynamodb:ReturnValues Filtrar com base no parâmetro ReturnValues de uma solicitação. Contém um dos seguintes: "ALL_OLD", "UPDATED_OLD", "ALL_NEW", "UPDATED_NEW" ou "NONE" String
dynamodb:Select Filtrar com base no parâmetro Select de uma solicitação de consulta ou exame String