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á.

# Gerenciamento das suas tags de alocação de custos usando a API do ElastiCache
<a name="Tagging.Managing.API"></a>

Você pode usar a API do ElastiCache para adicionar, modificar ou remover tags de alocação de custos.

Tags de alocação de custos são aplicadas em clusters do ElastiCache for Memcached. O cluster que receberá tag é especificado usando um ARN (Nome de recurso da Amazon).

Amostra de ARN: `arn:aws:elasticache:us-west-2:1234567890:cluster:my-cluster`

**Topics**
+ [Listagem de tags usando a API do ElastiCache](#Tagging.Managing.API.List)
+ [Adição de tags usando a API do ElastiCache](#Tagging.Managing.API.Add)
+ [Modificação de tags usando a API do ElastiCache](#Tagging.Managing.API.Modify)
+ [Remoção de tags usando a API do ElastiCache](#Tagging.Managing.API.Remove)

## Listagem de tags usando a API do ElastiCache
<a name="Tagging.Managing.API.List"></a>

Você pode usar a API do ElastiCache para listar tags em um recurso existente usando a operação [ListTagsForResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ListTagsForResource.html).

Para o Memcached, o código a seguir usa a API do ElastiCache para listar as tags no recurso `my-cluster` na região us-west-2.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ListTagsForResource
   &ResourceName=arn:aws:elasticache:us-west-2:0123456789:cluster:my-cluster
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Version=2015-02-02
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Para o Redis OSS, o código a seguir usa a API do ElastiCache para listar as tags no recurso `my-cluster-001` na região us-west-2.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ListTagsForResource
   &ResourceName=arn:aws:elasticache:us-west-2:0123456789:cluster:my-cluster-001
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Version=2015-02-02
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

## Adição de tags usando a API do ElastiCache
<a name="Tagging.Managing.API.Add"></a>

Você pode usar a API do ElastiCache para adicionar tags a um cluster do ElastiCache existente usando a operação [AddTagsToResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_AddTagsToResource.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 ElastiCache para adicionar as chaves `Service` e `Region` com os valores `elasticache` e `us-west-2` respectivamente. Para o Memcached, isso é aplicado ao recurso `my-cluster`. Para o Redis OSS, isso é aplicado ao recurso `my-cluster-001` na região us-west-2. 

**Memcached**

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=AddTagsToResource
   &ResourceName=arn:aws:elasticache:us-west-2:0123456789:cluster:my-cluster
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Tags.member.1.Key=Service 
   &Tags.member.1.Value=elasticache
   &Tags.member.2.Key=Region
   &Tags.member.2.Value=us-west-2
   &Version=2015-02-02
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

**Redis do**

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=AddTagsToResource
   &ResourceName=arn:aws:elasticache:us-west-2:0123456789:cluster:my-cluster-001
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Tags.member.1.Key=Service 
   &Tags.member.1.Value=elasticache
   &Tags.member.2.Key=Region
   &Tags.member.2.Value=us-west-2
   &Version=2015-02-02
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Para obter mais informações, consulte [AddTagsToResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_AddTagsToResource.html) na *Referência da API do Amazon ElastiCache*.

## Modificação de tags usando a API do ElastiCache
<a name="Tagging.Managing.API.Modify"></a>

Você pode usar a API do ElastiCache para modificar as tags em um cluster do ElastiCache.

Para modificar o valor de uma tag:
+ Use a operação [AddTagsToResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_AddTagsToResource.html) para adicionar uma nova tag e um valor ou para alterar o valor de uma tag existente.
+ Use [RemoveTagsFromResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_RemoveTagsFromResource.html) para remover tags do recurso.

A saída de qualquer operação será uma lista de tags e seus valores no recurso especificado.

Use [RemoveTagsFromResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_RemoveTagsFromResource.html) para remover tags do recurso.

## Remoção de tags usando a API do ElastiCache
<a name="Tagging.Managing.API.Remove"></a>

Você pode usar a API do ElastiCache para remover tags de um cluster do ElastiCache for Memcached existente usando a operação [RemoveTagsFromResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_RemoveTagsFromResource.html).

O código a seguir usa a API do ElastiCache para remover as tags com as chaves `Service` e `Region` do nó `my-cluster-001` no cluster `my-cluster` na região us-west-2.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=RemoveTagsFromResource
   &ResourceName=arn:aws:elasticache:us-west-2:0123456789:cluster:my-cluster-001
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &TagKeys.member.1=Service
   &TagKeys.member.2=Region
   &Version=2015-02-02
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```