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 do

• Snapshots do cluster

• Grupos de parâmetros

• Grupos de parâmetros de clusters

• Grupos de segurança

• Grupos de sub-rede

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, você pode etiquetar 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 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 AWS Management Console 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 Compreendendo os nomes do recursos da Amazon (ARN) do Amazon DocumentDB.

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 os valores de 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.

Adição e atualização de tags em um recurso do Amazon DocumentDB

É possível adicionar até 10 tags a um recurso usando o AWS Management Console ou o AWS CLI.

Using the AWS Management Console

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 AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

2. No painel de navegação, escolha clusters.

3. Escolha o nome do cluster ao qual você deseja adicionar tags.

4. Role para baixo até a seção Tags e depois escolha Edit (Editar).

5. 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 Key (Chave). Para alterar o valor de uma tag, localize o nome da tag na coluna Key (Chave).

   2. Para atribuir um valor novo ou atualizado à tag, insira um valor para a tag na caixa Value (Valor).

   3. Se você tiver mais tags para adicionar, escolha Add (Adicionar). Caso contrário, quando terminar, escolha Save (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 add-tags-to-resource da AWS CLI 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.

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.

Listando tags em um recurso do Amazon DocumentDB

Você pode usar o AWS Management Console ou a AWS CLI para obter uma lista das tags para um recurso do Amazon DocumentDB.

Using the AWS Management Console

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.

2. No painel de navegação, escolha clusters.

3. Escolha o nome do cluster para o qual você deseja listar tags.

4. 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 list-tags-for-resource da AWS CLI 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.

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"
        }
    ]
}

Removendo tags de um recurso do Amazon DocumentDB

Você pode usar o AWS Management Console ou a AWS CLI para remover tags de recursos do Amazon DocumentDB.

Using the AWS Management Console

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.

2. No painel de navegação, escolha clusters.

3. Escolha o nome do cluster do qual você deseja remover as tags.

4. Role para baixo até a seção Tags e depois escolha Edit (Editar).

5. Se você deseja remover todas as tags desse recurso, escolha Remove all (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 Key (Chave).

   2. Escolha Remove (Remover) na mesma linha que a chave de tag.

   3. Quando terminar, escolha Save (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 remove-tags-from-resource da AWS CLI 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.

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.