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á. # Marcação de recursos do Amazon DocumentDB Você pode usar tags do Amazon DocumentDB (compatível com MongoDB) para adicionar metadados aos recursos do Amazon DocumentDB. Essas tags podem ser usadas com AWS Identity and Access Management as políticas (IAM) para gerenciar o acesso aos recursos do Amazon DocumentDB e controlar quais ações podem ser aplicadas aos recursos. Você também pode usar as tags para monitorar custos agrupando despesas de recursos marcados com tags semelhantes. Você pode marcar os seguintes recursos do Amazon DocumentDB: + Clusters + Instâncias + Snapshots + Snapshots do cluster + Grupos de parâmetros + Grupos de parâmetros de clusters + Grupos de segurança + Grupos de sub-redes ## Visão geral de tags de recurso do Amazon DocumentDB Uma tag do Amazon DocumentDB é um par de nome/valor que você define e associa a um recurso do Amazon DocumentDB. O nome é referido como *chave*. Fornecer um valor para a chave é opcional. É possível usar tags para atribuir informações arbitrárias a um domínio do Amazon DocumentDB. É possível usar uma chave de tag, por exemplo, para definir uma categoria, e o valor da tag pode ser um item nessa categoria. Por exemplo, você pode definir uma chave de tag como `project` e um valor de tag de `Salix`, indicando que o recurso Amazon DocumentDB está atribuído ao projeto Salix. Você também pode usar tags para designar recursos do Amazon DocumentDB como usados ​​para teste ou produção usando uma chave como `environment=test` ou `environment=production`. Recomendamos que você use um conjunto consistente de chaves de tag para facilitar o rastreamento de metadados associados aos recursos do Amazon DocumentDB. Também é possível usar tags para organizar sua conta 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 mais informações, consulte [Using Cost Allocation Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *AWSGuia do usuário do Billing and Cost Management*. Cada recurso do Amazon DocumentDB tem um conjunto de tags que contém todas as tags atribuídas a esse recurso. Um conjunto de tags pode conter até 10 tags ou estar vazio. Se você adicionar uma tag a um recurso do Amazon DocumentDB que tenha a mesma chave de uma tag existente no recurso, o novo valor substituirá o valor antigo. AWSO não aplica nenhum significado semântico às tags. Elas são interpretadas estritamente como cadeias de caracteres. O Amazon DocumentDB pode definir tags em uma instância de banco de dados ou outros recursos do Amazon DocumentDB, dependendo das configurações usadas ao criar o recurso. Por exemplo, o Amazon DocumentDB pode adicionar uma tag indicando que uma instância é para produção ou teste. Você pode adicionar uma tag a um snapshot, mas sua conta não refletirá esse agrupamento. Você pode usar o Console de gerenciamento da AWS ou a AWS CLI para adicionar, listar e excluir tags dos recursos do Amazon DocumentDB. Ao usar a AWS CLI, você deve fornecer o nome do recurso da Amazon (ARN) para o recurso com o qual deseja trabalhar. Para obter mais informações sobre ARNs do Amazon DocumentDB, consulte [Entendendo o Amazon DocumentDB Amazon Resource Names () ARNs](documentdb-arns.md). ## Restrições de tag As restrições a seguir se aplicam às tags do Amazon DocumentDB: + Número máximo de tags por recurso - 10 + Comprimento máximo da **chave** - 128 caracteres Unicode + Comprimento máximo de **valor** - 256 caracteres Unicode + Caracteres válidos para **Chave** e **Valor** - letras maiúsculas e minúsculas no conjunto de caracteres UTF-8, dígitos, espaço e os seguintes caracteres: `_ . : / = + -` e `@` (Java regex: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`) + As chaves e valores das tags diferenciam maiúsculas de minúsculas. + O prefixo `aws:` não pode ser usado para chaves ou valores de tag; ele é reservado para a AWS. ## Adicionar e atualizar tags em um recurso do Amazon DocumentDB É possível adicionar até 10 tags a um recurso usando o Console de gerenciamento da AWS ou o AWS CLI. ------ #### [ Using the Console de gerenciamento da AWS ] O processo de adicionar uma tag a um recurso é semelhante, independentemente do recurso ao qual você está adicionando a tag. Neste exemplo, você adiciona uma tag a um cluster. **Para adicionar ou atualizar tags a um cluster usando o console** 1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB em [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). 1. No painel de navegação, escolha **clusters**. 1. Escolha o nome do cluster ao qual você deseja adicionar tags. 1. Role para baixo até a seção **Tags** e depois escolha **Editar**. 1. Para cada tag que você deseja adicionar a este recurso, faça o seguinte: 1. Para adicionar uma nova tag, insira o nome da tag na caixa **Chave**. Para alterar o valor de uma tag, localize o nome da tag na coluna **Chave**. 1. Para atribuir um valor novo ou atualizado à tag, insira um valor para a tag na caixa **Valor**. 1. Se você tiver mais tags para adicionar, escolha **Adicionar**. Caso contrário, quando terminar, escolha **Salvar**. ------ #### [ Using the AWS CLI ] O processo de adicionar uma tag a um recurso é semelhante, independentemente do recurso ao qual você está adicionando as tags. Neste exemplo, você adiciona três tags a um cluster. A segunda tag, `key2`, não tem valor. Use a operação AWS CLI da `add-tags-to-resource` com esses parâmetros. **Parâmetros** + **--resource-name**—O ARN do recurso do Amazon DocumentDB ao qual você deseja adicionar as tags. + **--tags**: uma lista das tags (par de chave/valor) que você deseja adicionar a esse recurso no formato `Key=key-name,Value=tag-value`. **Example** Para Linux, macOS ou Unix: ``` aws docdb add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3 ``` Para Windows: ``` aws docdb add-tags-to-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3 ``` A operação `add-tags-to-resource` não produzirá uma saída. Para ver os resultados da operação, use a operação `list-tags-for-resource`. ------ ## Listar tags em um recurso do Amazon DocumentDB Você pode usar o Console de gerenciamento da AWS ou a AWS CLI para obter uma lista das tags para um recurso do Amazon DocumentDB. ------ #### [ Using the Console de gerenciamento da AWS ] O processo de listar tags em um recurso é semelhante, independentemente do recurso ao qual você está adicionando a tag. Neste exemplo, você lista as tags para um cluster. **Para listar as tags em um cluster usando o console** 1. Abra o console do Amazon DocumentDB em [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). 1. No painel de navegação, escolha **clusters**. 1. Escolha o nome do cluster para o qual você deseja listar tags. 1. Para ver uma lista das tags nesse recurso, role para baixo até a seção **Tags**. ------ #### [ Using the AWS CLI ] O processo de listar as tags em um recurso é semelhante, independentemente do recurso para o qual você está listando a tag. Neste exemplo, você lista as tags em um cluster. Use a operação AWS CLI da `list-tags-for-resource` com esses parâmetros. **Parâmetros** + **--resource-name**—Obrigatório. O ARN do recurso do Amazon DocumentDB para o qual você deseja listar as tags para. **Example** Para Linux, macOS ou Unix: ``` aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` Para Windows: ``` aws docdb list-tags-for-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` A saída dessa operação é semelhante ao seguinte (formato JSON). ``` { "TagList": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "" }, { "Key": "key3", "Value": "value3" } ] } ``` ------ ## Remover tags de um recurso do Amazon DocumentDB Você pode usar o Console de gerenciamento da AWS ou a AWS CLI para remover tags de recursos do Amazon DocumentDB. ------ #### [ Using the Console de gerenciamento da AWS ] O processo de remover tags de um recurso é semelhante, independentemente do recurso do qual você está removendo a tag. Neste exemplo, você remove as tags de um cluster. **Para remover tags de um cluster usando o console** 1. Abra o console do Amazon DocumentDB em [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). 1. No painel de navegação, escolha **clusters**. 1. Escolha o nome do cluster do qual você deseja remover as tags. 1. Role para baixo até a seção **Tags** e depois escolha **Edit (Editar)**. 1. Se você deseja remover todas as tags desse recurso, escolha **Remover todas**. Caso contrário, para cada tag que você deseja remover deste recurso, faça o seguinte: 1. Localize o nome da tag na coluna **Chave**. 1. Escolha **Remover** na mesma linha que a chave de tag. 1. Quando terminar, escolha **Salvar**. ------ #### [ Using the AWS CLI ] O processo de remover uma tag de um recurso é semelhante, independentemente do recurso do qual você está removendo a tag. Neste exemplo, você remove a tag de um cluster. Use a operação AWS CLI da `remove-tags-from-resource` com esses parâmetros. + **--resource-name**—Obrigatório. O ARN do recurso do Amazon DocumentDB do qual você deseja remover as tags. + **--tag-keys**—Obrigatório. Uma lista das chaves de tag que você deseja remover deste recurso. **Example** Para Linux, macOS ou Unix: ``` aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` Para Windows: ``` aws docdb remove-tags-from-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` A operação `removed-tags-from-resource` não produzirá uma saída. Para ver os resultados da operação, use a operação `list-tags-for-resource`. ------