Marcar recursos no AWS Database Migration Service - AWS Database Migration Service
API

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Marcar recursos no AWS Database Migration Service

É possível utilizar tags no AWS Database Migration Service (AWS DMS) para adicionar metadados aos recursos. Além disso, é possível utilizar essas tags com políticas do AWS Identity and Access Management (IAM) para gerenciar o acesso aos recursos do AWS DMS e controlar as ações que podem ser aplicadas aos recursos do AWS DMS. Por fim, utilize essas tags para monitorar os custos agrupando as despesas de recursos marcados com tags semelhantes.

Todos os recursos do AWS DMS podem ser marcados com tags:

  • Certificados

  • Provedores de dados

  • Migrações de dados

  • Endpoints

  • Assinaturas de eventos

  • Perfis de instância

  • Projetos de migração

  • Instâncias de replicação

  • Grupos de sub-rede de replicação

  • Tarefas de replicação

Uma tag do AWS DMS é um par de nome-valor que você define e associa a um recurso do AWS DMS. O nome é referido como a chave. Fornecer um valor para a chave é opcional. É possível utilizar tags para atribuir informações arbitrárias a um domínio do AWS DMS. Uma chave de tags pode ser usada, por exemplo, para definir uma categoria, e o valor da tag pode ser um item nessa categoria. Por exemplo, é possível definir uma chave de tag de "projeto" e um valor de tag de "Salix", indicando que o recurso do AWS DMS é atribuído ao projeto Salix. As tags também podem ser utilizadas para designar recursos do AWS DMS como sendo utilizados para testes ou produção, utilizando uma tag como environment=teste ou environment=produção. É recomendável utilizar um conjunto consistente de chaves de tags para facilitar o monitoramento de metadados associados aos recursos do AWS DMS.

Também é possível utilizar tags para organizar sua fatura da AWS para refletir sua própria estrutura de custo. Para fazer isso, inscreva-se para obter a fatura da sua Conta da AWS com os valores de chave de tag incluídos. Então, para ver o custo de recursos combinados, organize suas informações de faturamento de acordo com recursos com os mesmos valores de chave de tags. Por exemplo, é possível marcar vários recursos com um nome de aplicação específico, e depois organizar suas informações de faturamento para ver o custo total daquela aplicação em vários serviços. Para obter mais informações, consulte Usar tags de alocação de custos no Guia do usuário do AWS Billing.

Cada recurso do AWS DMS tem um conjunto de tags que contém todas as tags atribuídas àquele recurso do AWS DMS. Um conjunto de tags pode conter até dez tags ou estar vazio. Se você adicionar uma tag a um recurso do AWS DMS que tenha a mesma chave que uma tag existente no recurso, o novo valor substituirá o antigo.

A AWS não aplica nenhum significado semântico às tags. Elas são interpretadas estritamente como cadeias de caracteres da AWS. O DMS pode definir tags em recurso do AWS DMS, dependendo das configurações utilizadas ao criar o recurso.

A lista a seguir descreve as características de uma tag do AWS DMS.

  • A chave de tags é o nome obrigatório da tag. O valor da string pode ter de 1 a 128 caracteres Unicode e não pode ter os prefixos "aws:" ou "dms:". A string pode conter apenas o conjunto de letras Unicode, dígitos, espaço em branco, “_”, “.”, “/”, “=”, “+”, “-” (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

  • O valor da tag é um valor de string opcional da tag. O valor da string pode ter de 1 a 256 caracteres Unicode e não pode ter os prefixos "aws:" ou "dms:". A string pode conter apenas o conjunto de letras Unicode, dígitos, espaço em branco, “_”, “.”, “/”, “=”, “+”, “-” (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

    Os valores não têm que ser exclusivos em um conjunto de tags e podem ser nulos. Por exemplo, é possível ter um par de chave-valor em um conjunto de tags definido como projeto/Trinity e centro-custos/Trinity.

É possível utilizar a AWS CLI ou a API do AWS DMS para adicionar, listar e excluir tags dos recursos do AWS DMS. Ao utilizar a AWS CLI ou a API do AWS DMS, forneça o nome de recurso da Amazon (ARN) para o recurso do AWS DMS com o qual deseja trabalhar. Para obter mais informações sobre a criação de um ARN, consulte Construindo um nome de recurso da Amazon (ARN) para AWS DMS.

Observe que as tags ficam armazenadas em cache para fins de autorização. Por isso, as adições e atualizações em tags de recursos do AWS DMS podem demorar vários minutos para serem disponibilizadas.

API

É possível adicionar, listar ou remover tags de um recurso do AWS DMS utilizando a API do AWS DMS.

Para saber mais sobre como criar o ARN necessário, consulte Construindo um nome de recurso da Amazon (ARN) para AWS DMS.

Ao trabalhar com o XML utilizando a API do AWS DML, as tags utilizam o seguinte esquema:

<Tagging>
  <TagSet>
  	<Tag>
  		<Key>Project</Key>
  		<Value>Trinity</Value>
  	</Tag>
  	<Tag>
  		<Key>User</Key>
  		<Value>Jones</Value>
  	</Tag>
  </TagSet>
</Tagging>

A tabela a seguir fornece uma lista das tags XML permitidas e suas características. Observe que os valores de Chave e Valor diferenciam maiúsculas e minúsculas. Por exemplo, projeto=Trinity e PROJETO=Trinity são duas tags distintas.

Elemento de marcação por tag Descrição
TagSet Um conjunto de tags é um contêiner de todas as tags atribuídas a um recurso do Amazon RDS. Só pode haver um conjunto de tags por recurso. Você trabalha com um TagSet somente por meio da API do AWS DMS.
Tag Uma tag é um par de chave-valor definido pelo usuário. Pode haver de 1 a 10 tags em um conjunto de tags.
Chave

Uma chave é o nome obrigatório da tag. O valor da string pode ter de 1 a 128 caracteres Unicode e não pode ter os prefixos "dms:" or "aws:". A string pode conter apenas o conjunto de letras Unicode, dígitos, espaço em branco, “_”, “.”, “/”, “=”, “+”, “-” (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

As chaves devem ser exclusivas a um conjunto de tags. Por exemplo, não pode haver um par de chaves em um conjunto de tags com a mesma chave com valores diferentes, como projeto/Trinity e projeto/Xanadu.

Valor

Um valor é o valor opcional da tag. O valor da string pode ter de 1 a 256 caracteres Unicode e não pode ter os prefixos "dms:" or "aws:". A string pode conter apenas o conjunto de letras Unicode, dígitos, espaço em branco, “_”, “.”, “/”, “=”, “+”, “-” (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

Os valores não têm que ser exclusivos em um conjunto de tags e podem ser nulos. Por exemplo, é possível ter um par de chave-valor em um conjunto de tags definido como projeto/Trinity e centro-custos/Trinity.