

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

# Gerenciando suas etiquetas de alocação de custos usando o AWS CLI
<a name="Tagging.Managing.CLI"></a>

Você pode usar o AWS CLI para adicionar, modificar ou remover tags de alocação de custos.

As etiquetas de alocação de custos são aplicadas aos ElastiCache clusters. 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**
+ [Listando tags usando o AWS CLI](#Tagging.Managing.CLI.List)
+ [Adicionando tags usando o AWS CLI](#Tagging.Managing.CLI.Add)
+ [Modificando tags usando o AWS CLI](#Tagging.Managing.CLI.Modify)
+ [Removendo tags usando o AWS CLI](#Tagging.Managing.CLI.Remove)

## Listando tags usando o AWS CLI
<a name="Tagging.Managing.CLI.List"></a>

Você pode usar as tags AWS CLI para listar em um ElastiCache recurso existente usando a [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticache/list-tags-for-resource.html) operação.

O código a seguir usa o AWS CLI para listar as tags no cluster Memcached `my-cluster` na região us-west-2.

Para Linux, macOS ou Unix:

```
aws elasticache list-tags-for-resource \
  --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster}}
```

Para Windows:

```
aws elasticache list-tags-for-resource ^
  --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster}}
```

O código a seguir usa o AWS CLI para listar as tags no nó Valkey ou Redis OSS `my-cluster-001` no `my-cluster` cluster na região us-west-2.

Para Linux, macOS ou Unix:

```
aws elasticache list-tags-for-resource \
  --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster-001}}
```

Para Windows:

```
aws elasticache list-tags-for-resource ^
  --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster-001}}
```

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

```
{
   "TagList": []
}
```

Para obter mais informações, consulte o AWS CLI for ElastiCache [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticache/list-tags-for-resource.html).

## Adicionando tags usando o AWS CLI
<a name="Tagging.Managing.CLI.Add"></a>

Você pode usar o AWS CLI para adicionar tags a um ElastiCache recurso existente usando a operação [add-tags-to-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticache/add-tags-to-resource.html) 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 o AWS CLI para adicionar as chaves `Service` e `Region` com os valores `elasticache` e`us-west-2`, respectivamente, ao nó `my-cluster-001` no cluster `my-cluster` na região us-west-2.

**Memcached**

Para Linux, macOS ou Unix:

```
aws elasticache add-tags-to-resource \
 --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster}} \
 --tags Key={{Service}},Value={{elasticache}} \
        Key={{Region}},Value={{us-west-2}}
```

Para Windows:

```
aws elasticache add-tags-to-resource ^
 --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster}} ^
 --tags Key={{Service}},Value={{elasticache}} ^
        Key={{Region}},Value={{us-west-2}}
```

**Redis**

Para Linux, macOS ou Unix:

```
aws elasticache add-tags-to-resource \
 --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster-001}} \
 --tags Key={{Service}},Value={{elasticache}} \
        Key={{Region}},Value={{us-west-2}}
```

Para Windows:

```
aws elasticache add-tags-to-resource ^
 --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster-001}} ^
 --tags Key={{Service}},Value={{elasticache}} ^
        Key={{Region}},Value={{us-west-2}}
```

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": "elasticache",
         "Key": "Service"
      },
      {
         "Value": "us-west-2",
         "Key": "Region"
      }
   ]
}
```

Para obter mais informações, consulte o AWS CLI for ElastiCache [add-tags-to-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticache/add-tags-to-resource.html).

Você também pode usar o AWS CLI para adicionar tags a um cluster ao criar um novo cluster usando a operação[create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html). Você não pode adicionar tags ao criar um cluster usando o console ElastiCache de gerenciamento. Depois que o cluster é criado, você pode usar o console para adicionar tags ao cluster.

## Modificando tags usando o AWS CLI
<a name="Tagging.Managing.CLI.Modify"></a>

Você pode usar o AWS CLI para modificar as tags em um ElastiCache cluster.

Para modificar tags:
+ Use [add-tags-to-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticache/add-tags-to-resource.html) para adicionar uma nova tag e um valor ou para alterar o valor associado a uma tag existente.
+ Use [remove-tags-from-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticache/remove-tags-from-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.

## Removendo tags usando o AWS CLI
<a name="Tagging.Managing.CLI.Remove"></a>

Você pode usar o AWS CLI para remover tags de um cluster existente ElastiCache do Memcached usando a [remove-tags-from-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticache/remove-tags-from-resource.html) operação.

Para o Memcached, o código a seguir usa o AWS CLI para remover as tags com as chaves `Service` e `Region` do nó no cluster `my-cluster-001` `my-cluster` na região us-west-2.

Para Linux, macOS ou Unix:

```
aws elasticache remove-tags-from-resource \
 --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster}} \
 --tag-keys {{PM Service}}
```

Para Windows:

```
aws elasticache remove-tags-from-resource ^
 --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster}} ^
 --tag-keys {{PM Service}}
```

Para o Redis OSS, o código a seguir usa o AWS CLI para remover as tags com as chaves `Service` e `Region` do nó no cluster `my-cluster-001` `my-cluster` na região us-west-2.

Para Linux, macOS ou Unix:

```
aws elasticache remove-tags-from-resource \
 --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster-001}} \
 --tag-keys {{PM Service}}
```

Para Windows:

```
aws elasticache remove-tags-from-resource ^
 --resource-name arn:aws:elasticache:{{us-west-2:0123456789:cluster:my-cluster-001}} ^
 --tag-keys {{PM 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 o AWS CLI for ElastiCache [remove-tags-from-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticache/remove-tags-from-resource.html).