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 dos seus recursos do MemoryDB
Para ajudar você a gerenciar seus clusters e outros recursos do MemoryDB, é possível atribuir seus próprios metadados a cada recurso na forma de tags. As tags permitem categorizar seus recursos da AWS de diferentes formas (como por finalidade, por proprietário ou por ambiente). Isso é útil quando você tem muitos recursos do mesmo tipo. É possível identificar rapidamente um recurso específico baseado nas tags que você atribuiu a ele. Este tópico descreve tags e mostra a você como criá-las.
**Atenção**
Como uma prática recomendada, sugerimos que você não inclua dados confidenciais nas suas tags.
## Conceitos Básicos de Tags
Uma tag um rótulo atribuído a um recurso AWS. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você. As tags permitem categorizar seus recursos da AWS de diferentes formas, por exemplo, por finalidade ou por proprietário. Por exemplo, você pode definir um conjunto de tags para os clusters do MemoryDB da sua conta que o ajudem a rastrear o proprietário e o grupo de usuários de cada cluster.
Recomendamos que você desenvolva um conjunto de chave de tags que atenda suas necessidades para cada tipo de recurso. Usar um conjunto consistente de chaves de tags facilita para você gerenciar seus recursos. É possível pesquisar e filtrar os recursos de acordo com as tags que adicionar. Para obter mais informações sobre como implementar uma estratégia eficaz de marcação de recursos, consulte o [whitepaper da AWS, Práticas recomendadas de marcação](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf).
As tags não têm nenhum significado semântico para o MemoryDB e são interpretadas estritamente como uma sequência de caracteres. Além disso, as tags não são automaticamente atribuídas aos seus recursos. É possível editar chaves de tags e valores e é possível remover as tags de um recurso a qualquer momento. É possível definir o valor de uma tag como `null`. Ao adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo. Se você excluir um recurso, todas as tags do recurso também serão excluídas.
Você pode trabalhar com tags usando o Console de gerenciamento da AWS, a AWS CLI e a API do MemoryDB.
Se você estiver usando o IAM, pode controlar quais usuários na sua conta da AWS têm permissão para criar, editar ou excluir tags. Para obter mais informações, consulte [Permissões em nível de recurso](iam.resourcelevelpermissions.md).
## Recursos que podem ser marcados
Você pode usar tags na maioria dos recursos do MemoryDB que já existem em sua conta. A tabela a seguir lista os recursos compatíveis com o uso de tags. Se você estiver usando o Console de gerenciamento da AWS, é possível aplicar tags aos recursos usando o [Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html). Algumas telas de recursos permitem que você especifique tags para um recurso ao criá-lo; por exemplo, uma tag com uma chave de nome e um valor que você especificar. Na maioria dos casos, o console aplicará as tags imediatamente depois de o recurso ser criado (em vez de durante a criação de recursos). O console pode organizar os recursos de acordo com a tag **Nome**, mas essa tag não tem nenhum significado semântico para o serviço do MemoryDB.
Além disso, algumas ações de criação de recursos permitem que você especifique tags para um recurso quando ele é criado. Se as tags não puderem ser aplicadas durante a criação dos recursos, nós reverteremos o processo de criação de recursos. Isso garante que os recursos sejam criados com tags ou, então, não criados, e que nenhum recurso seja deixado sem tags. Ao marcar com tags os recursos no momento da criação, você elimina a necessidade de executar scripts personalizados de uso de tags após a criação do recurso.
Se estiver usando a API do MemoryDB da Amazon, a CLI da AWS ou um SDK da AWS, você poderá usar o parâmetro `Tags` na ação relevante da API do MemoryDB para aplicar tags. Eles são:
+ `CreateCluster`
+ `CopySnapshot`
+ `CreateParameterGroup`
+ `CreateSubnetGroup`
+ `CreateSnapshot`
+ `CreateACL`
+ `CreateUser`
+ `CreateMultiRegionCluster`
A tabela a seguir descreve os recursos do MemoryDB que podem ser marcados e os recursos que podem ser marcados na criação usando a API do MemoryDB, a CLI da AWS ou um SDK da AWS.
**Suporte à marcação para recursos do MemoryDB**
| Recurso | Compatível com tags | Oferece suporte à marcação na criação |
| --- | --- | --- |
| ParameterGroup | Sim | Sim |
| SubnetGroup | Sim | Sim |
| cluster | Sim | Sim |
| snapshot | Sim | Sim |
| usuário | Sim | Sim |
| acl | Sim | Sim |
| multiregioncluster | Sim | Sim |
É possível aplicar permissões em nível de recurso baseadas em tags em suas políticas do IAM às ações da API do MemoryDB que oferecem suporte à marcação na criação para implementar um controle granular sobre os usuários e grupos que podem marcar recursos na criação. Seus recursos estão devidamente protegidos a partir da criação. As tags são aplicadas imediatamente aos recursos. Portanto, todas as permissões em nível de recurso baseadas em tags que controlam o uso de recursos entram imediatamente em vigor. Seus recursos podem ser rastreados e relatados com mais precisão. É possível obrigar o uso de marcação com tags nos novos recursos e controlar quais chaves e valores de tag são definidos nos seus recursos.
Para obter mais informações, consulte [Exemplo de marcação de recursos](#tagging-your-resources-example).
Para obter mais informações sobre como marcar os seus recursos para o faturamento, consulte [Monitoramento de custos com tags de alocação de custos](tagging.md).
## Marcação de clusters e snapshots, e clusters multirregionais
As seguintes regras se aplicam à marcação como parte das operações de solicitação:
+ **CreateCluster**:
+ Se o `--cluster-name` for fornecido:
Se as tags forem incluídas na solicitação, o cluster será marcado.
+ Se o `--snapshot-name` for fornecido:
Se as tags forem incluídas na solicitação, o cluster será marcado somente com essas tags. Se nenhuma tag for incluída na solicitação, as tags de snapshot serão adicionadas ao cluster.
+ **CreateSnapshot** :
+ Se o `--cluster-name` for fornecido:
Se as tags forem incluídas na solicitação, somente as tags de solicitação serão adicionadas ao snapshot. Se nenhuma tag for incluída na solicitação, as tags de cluster de cache serão adicionadas ao snapshot.
+ Para snapshots automáticos:
As tags serão propagadas a partir das tags do cluster.
+ **CopySnapshot** :
Se as tags forem incluídas na solicitação, somente as tags de solicitação serão adicionadas ao snapshot. Se nenhuma tag for incluída na solicitação, as tags de snapshot da origem serão adicionadas ao snapshot copiado.
+ **TagResource** e **UntagResource**:
As tags serão adicionadas/removidas do recurso.
## Marcação de clusters multirregionais
Os clusters multirregionais do MemoryDB são um recurso global. Dessa forma, as tags podem ser especificadas, modificadas ou listadas em clusters de multirregionais invocando as APIs relevantes em qualquer região com a qual o MemoryDB multirregional seja compatível. Consulte mais informações sobre a compatibilidade de regiões em [Pré-requisitos e limitações](multi-region.prereq.md).
As tags em clusters multirregionais são independentes das tags em clusters regionais. É possível especificar diferentes conjuntos de tags em um cluster multirregional e em seus clusters regionais correspondentes. Não há conexão hierárquica entre essas tags e elas não são copiadas pela hierarquia entre esses tipos de recursos.
Ao adicionar ou remover tags por meio das APIs `TagResource` e `UntagResource`, você pode não ver imediatamente as tags efetivas mais recentes na resposta da API ListTags, devido à consistência eventual das tags, especificamente para clusters multirregionais.
## Restrições de tag
As restrições básicas a seguir se aplicam a tags:
+ Número máximo de tags por recurso –- 50
+ Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor.
+ Comprimento máximo da chave – 128 caracteres Unicode em UTF-8.
+ Comprimento máximo do valor – 256 caracteres Unicode em UTF-8.
+ Embora o MemoryDB permita qualquer caractere em suas tags, outros serviços podem ser restritivos. Os caracteres permitidos nos serviços são: letras, números e espaços representáveis em UTF-8 e os seguintes caracteres: \$1 - = . \$1 : / @
+ As chaves e os valores de tags diferenciam maiúsculas de minúsculas.
+ O prefixo `aws:` é reservado para uso da AWS. Não é possível editar nem excluir a chave ou o valor de uma tag quando ela tem uma chave de tag com esse prefixo. As tags com o prefixo `aws:` não contam para as tags por limite de recurso.
Você não pode encerrar, parar ou excluir um recurso baseado unicamente em suas tags; será preciso especificar o identificador de recursos. Por exemplo, para excluir snapshots marcados com uma chave de tag chamada `DeleteMe`, use a ação `DeleteSnapshot` com os identificadores de recursos dos snapshots, como `snap-1234567890abcdef0`.
Para obter mais informações sobre os recursos do MemoryDB que você pode usar tags, consulte [Recursos que podem ser marcados](#tagging-your-resources).
## Exemplo de marcação de recursos
+ Adicionar tags a um cluster.
```
aws memorydb tag-resource \
--resource-arn arn:aws:memorydb:us-east-1:111111222233:cluster/my-cluster \
--tags Key="project",Value="XYZ" Key="memorydb",Value="Service"
```
+ Criação de um cluster usando tags.
```
aws memorydb create-cluster \
--cluster-name testing-tags \
--description cluster-test \
--subnet-group-name test \
--node-type db.r6g.large \
--acl-name open-access \
--tags Key="project",Value="XYZ" Key="memorydb",Value="Service"
```
+ Criação de um snapshot com tags.
Para esse caso, se você adicionar tags sob solicitação, mesmo que o cluster contenha tags, o snapshot receberá somente as tags da solicitação.
```
aws memorydb create-snapshot \
--cluster-name testing-tags \
--snapshot-name bkp-testing-tags-mycluster \
--tags Key="work",Value="foo"
```
# Monitoramento de custos com tags de alocação de custos
Ao adicionar etiquetas de alocação de custos aos recursos no MemoryDB, você pode acompanhar os custos agrupando as despesas nas suas faturas por valores de etiqueta de recurso.
Uma tag de alocação de custos do MemoryDB é um par de valores-chave que você define e associa a um recurso do MemoryDB. A chave e o valor diferenciam maiúsculas de minúsculas. Você pode usar uma chave de tag para definir uma categoria, e o valor da tag pode ser um item nessa categoria. Por exemplo, você pode definir uma chave de tag de `CostCenter` e um valor de tag de `10010`, indicando que o recurso está atribuído ao centro de custo 10010. Você também pode usar tags para designar recursos como sendo usados para teste ou produção, usando uma chave como `Environment` e valores como `test` ou `production`. Recomendamos que você use um conjunto consistente de chaves de tag para facilitar o rastreamento dos custos associados aos seus recursos.
Use tags de alocação de custos para organizar sua fatura da AWS para refletir sua própria estrutura de custos. Para isso, inscreva-se para obter 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.
Você também pode combinar tags para rastrear custos com um maior nível de detalhes. Por exemplo, para rastrear seus custos de serviços por região, você pode usar as chaves de tag `Service` e `Region`. Em um recurso, você pode ter os valores `MemoryDB` e `Asia Pacific (Singapore)` e, em outro recurso, os valores `MemoryDB` e `Europe (Frankfurt)`. você pode, então, ver seus custos totais do MemoryDB divididos por região. Para obter mais informações, consulte [ Usar tags de alocação de custos ](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia do usuário do AWS Billing*.
Você pode adicionar tags de alocação de custo em clusters do MemoryDB. Ao adicionar, listar, modificar, copiar ou remover uma tag, a operação é aplicada somente ao cluster especificado.
**Características das tags de alocação de custos do MemoryDB**
+ As etiquetas de alocação de custos são aplicadas aos recursos do MemoryDB que são especificados nas operações de CLI e API como um ARN. O tipo de recurso será um "cluster".
Formato ARN: `arn:aws:memorydb:::/`
ARN de exemplo: `arn:aws:memorydb:us-east-1:1234567890:cluster/my-cluster`
+ A chave de tags é o nome obrigatório da tag. O valor da string da chave pode ser de 1 a 128 caracteres Unicode e não pode ser prefixado com `aws:`. A string pode conter apenas o conjunto de letras Unicode, dígitos, espaços em branco, sublinhados (\$1), pontos finais (.), dois-pontos (:), barras invertidas (\$1), sinais de igualdade (=), sinais de adição (\$1), hífens (-) ou sinais de arroba (@).
+ O valor da tag é o valor opcional da tag. O valor da string do valor pode ser de 1 a 256 caracteres Unicode e não pode ser prefixado com `aws:`. A string pode conter apenas o conjunto de letras Unicode, dígitos, espaços em branco, sublinhados (\$1), pontos finais (.), dois-pontos (:), barras invertidas (\$1), sinais de igualdade (=), sinais de adição (\$1), hífens (-) ou sinais de arroba (@).
+ Um recurso do MemoryDB pode ter no máximo 50 tags.
+ Os valores não têm que ser exclusivos em um conjunto de tags. Por exemplo, você pode ter um conjunto de tags no qual as chaves `Service` e `Application` têm ambas o valor `MemoryDB`.
AWSA não aplica nenhum significado semântico às suas tags. As tags são interpretadas estritamente como cadeias de caracteres. A AWS não define automaticamente nenhuma tag em nenhum recurso do MemoryDB.
# Gerenciamento das suas tags de alocação de custos usando a AWS CLI
Você pode usar a AWS CLI para adicionar, modificar ou remover tags de alocação de custos.
Amostra de ARN: `arn:aws:memorydb:us-east-1:1234567890:cluster/my-cluster`
**Topics**
+ [Listagem de tags usando a AWS CLI](#tagging.managing.cli.List)
+ [Adição de tags usando a AWS CLI](#tagging.managing.cli.Add)
+ [Modificação de tags usando a AWS CLI](#tagging.managing.cli.modify)
+ [Remoção der tags usando a AWS CLI](#tagging.managing.cli.Remove)
## Listagem de tags usando a AWS CLI
Você pode usar a opção AWS CLI para listar tags em um recurso existente do MemoryDB usando a operação [list-tags](https://docs.aws.amazon.com/cli/latest/reference/memorydb/list-tags.html).
O código a seguir usa a AWS CLI para listar as tags no cluster `my-cluster` do MemoryDB na região us-east-1.
Para Linux, macOS ou Unix:
```
aws memorydb list-tags \
--resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster
```
Para Windows:
```
aws memorydb list-tags ^
--resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster
```
A saída dessa operação será semelhante a uma lista de todas as tags no recurso.
```
{
"TagList": [
{
"Value": "10110",
"Key": "CostCenter"
},
{
"Value": "EC2",
"Key": "Service"
}
]
}
```
Se não houver tags no recurso, a saída será uma TagList vazia.
```
{
"TagList": []
}
```
Para obter mais informações, consulte a AWS CLI para a [lista de tags](https://docs.aws.amazon.com/cli/latest/reference/memorydb/list-tags.html) do MemoryDB.
## Adição de tags usando a AWS CLI
Você pode usar a AWS CLI para adicionar tags a um recurso do MemoryDB existente usando a operação [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/tag-resource.html) da CLI. Se a chave de tag não existir no recurso, a chave e o valor serão adicionados ao recurso. Se a chave já existir no recurso, o valor associado a essa chave será atualizado para o novo valor.
O código a seguir usa AWS CLI para adicionar as chaves `Service` e `Region` com os valores `memorydb` e `us-east-1`, respectivamente, ao cluster `my-cluster` na região us-east-1.
Para Linux, macOS ou Unix:
```
aws memorydb tag-resource \
--resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster \
--tags Key=Service,Value=memorydb \
Key=Region,Value=us-east-1
```
Para Windows:
```
aws memorydb tag-resource ^
--resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster ^
--tags Key=Service,Value=memorydb ^
Key=Region,Value=us-east-1
```
A saída dessa operação será semelhante a uma lista de todas as tags no recurso após a operação, conforme mostrado a seguir.
```
{
"TagList": [
{
"Value": "memorydb",
"Key": "Service"
},
{
"Value": "us-east-1",
"Key": "Region"
}
]
}
```
Para obter mais informações, consulte AWS CLI para MemoryDB[tag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/tag-resource.html).
Você também pode usar AWS CLI para adicionar tags a um cluster ao criar um novo cluster usando a operação [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/memorydb/create-cluster.html).
## Modificação de tags usando a AWS CLI
Você pode usar AWS CLI para modificar as tags em um cluster do MemoryDB.
Para modificar tags:
+ Use [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/tag-resource.html) para adicionar uma nova tag e um valor ou para alterar o valor associado a uma tag existente.
+ Use [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/untag-resource.html) para remover tags especificadas do recurso.
A saída de qualquer operação será uma lista de tags e seus valores no cluster especificado.
## Remoção der tags usando a AWS CLI
Você pode usar a operação [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/untag-resource.html) da AWS CLI para remover tags de um cluster existente do MemoryDB.
O código a seguir usa a AWS CLI para remover as etiquetas com as chaves `Service` e `Region` do cluster `my-cluster` na região us-east-1.
Para Linux, macOS ou Unix:
```
aws memorydb untag-resource \
--resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster \
--tag-keys Region Service
```
Para Windows:
```
aws memorydb untag-resource ^
--resource-arn arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster ^
--tag-keys Region Service
```
A saída dessa operação será semelhante a uma lista de todas as tags no recurso após a operação, conforme mostrado a seguir.
```
{
"TagList": []
}
```
Para obter mais informações, consulte AWS CLI para [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/memorydb/untag-resource.html) do MemoryDB.
# Gerenciar suas tags de alocação de custos usando a API do MemoryDB
Você pode usar a API do MemoryDB para adicionar, modificar ou remover tags de alocação de custos.
Tags de alocação de custos são aplicadas para clusters do MemoryDB. O cluster que receberá tag é especificado usando um ARN (Nome de recurso da Amazon).
Amostra de ARN: `arn:aws:memorydb:us-east-1:1234567890:cluster/my-cluster`
**Topics**
+ [Listagem de tags usando a API do MemoryDB](#tagging.managing.api.List)
+ [Adicionar tags usando a API do MemoryDB](#tagging.managing.api.Add)
+ [Modificação de tags usando a API do MemoryDB](#tagging.managing.api.modify)
+ [Remover tags usando a API do MemoryDB](#tagging.managing.api.Remove)
## Listagem de tags usando a API do MemoryDB
Você pode usar a API do MemoryDB para listar tags em um recurso existente usando a operação [ListTags](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_ListTags.html).
O código a seguir usa a API do MemoryDB para listar as tags no recurso `my-cluster` na região us-east-1.
```
https://memory-db.us-east-1.amazonaws.com/
?Action=ListTags
&ResourceArn=arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Version=2021-01-01
&Timestamp=20210802T192317Z
&X-Amz-Credential=
```
## Adicionar tags usando a API do MemoryDB
Você pode usar a API do MemoryDB para adicionar tags a um cluster do MemoryDB existente usando a operação [TagResource](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_TagResource.html). Se a chave de tag não existir no recurso, a chave e o valor serão adicionados ao recurso. Se a chave já existir no recurso, o valor associado a essa chave será atualizado para o novo valor.
O código a seguir usa a API do MemoryDB para adicionar as chaves `Service` e `Region` com os valores `memorydb` e `us-east-1`, respectivamente, ao recurso `my-cluster` na região us-east-1.
```
https://memory-db.us-east-1.amazonaws.com/
?Action=TagResource
&ResourceArn=arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Tags.member.1.Key=Service
&Tags.member.1.Value=memorydb
&Tags.member.2.Key=Region
&Tags.member.2.Value=us-east-1
&Version=2021-01-01
&Timestamp=20210802T192317Z
&X-Amz-Credential=
```
Para mais informações, consulte [TagResource](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_TagResource.html).
## Modificação de tags usando a API do MemoryDB
Você pode usar a API do MemoryDB para modificar as tags em um cluster do MemoryDB.
Para modificar o valor de uma tag:
+ Use a operação [TagResource](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_TagResource.html) para adicionar uma nova tag e um valor ou para alterar o valor de uma tag existente.
+ Para remover tags de um recurso, use a ação [UntagResource](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UntagResource.html).
A saída de qualquer operação será uma lista de tags e seus valores no recurso especificado.
## Remover tags usando a API do MemoryDB
Você pode usar a API do MemoryDB para remover tags de um cluster do MemoryDB existente usando a operação [UntagResource](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UntagResource.html).
O código a seguir usa a API do MemoryDB para remover as tags com as chaves `Service` e `Region` do cluster `my-cluster` na região us-east-1.
```
https://memory-db.us-east-1.amazonaws.com/
?Action=UntagResource
&ResourceArn=arn:aws:memorydb:us-east-1:0123456789:cluster/my-cluster
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&TagKeys.member.1=Service
&TagKeys.member.2=Region
&Version=2021-01-01
&Timestamp=20210802T192317Z
&X-Amz-Credential=
```