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 políticas AWS Identity and Access Management (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. Você pode usar etiquetas para organizar sua AWS fatura de forma a refletir sua própria estrutura de custos. Para fazer isso, inscreva-se para receber sua Conta da AWS fatura com os valores-chave da etiqueta 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 *AWS Guia 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. AWS não aplica nenhum significado semântico às suas tags; as tags 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 o AWS CLI para adicionar, listar e excluir tags nos recursos do Amazon DocumentDB. Ao usar o AWS CLI, você deve fornecer o Amazon Resource Name (ARN) para o recurso com o qual deseja trabalhar. Para obter mais informações sobre ARNs do Amazon DocumentDB, consulte [Compreender os nomes do recursos da Amazon (ARN) do Amazon DocumentDB](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 UTF-8 caracteres, dígitos, espaço e os seguintes caracteres: `_ . : / = + -` e `@` (regex Java:) `"^([\\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 Você pode adicionar até 10 tags a um recurso usando o Console de gerenciamento da AWS ou AWS CLI o. ------ #### [ 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 e abra Console de gerenciamento da AWS 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 AWS CLI operação `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 o AWS CLI para obter uma lista das tags de 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 AWS CLI operação `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 o AWS CLI para remover tags dos 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 AWS CLI operação `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`. ------