本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon CLI 管理成本分配标签
<a name="Tagging.Managing.CLI"></a>

您可以使用 Amazon CLI 添加、修改或删除成本分配标签。

成本分配标签应用于 ElastiCache 集群。要添加标签的集群是使用 ARN（Amazon 资源名称）指定的。

示例 arn：`arn:aws:elasticache:us-west-2:1234567890:cluster:my-cluster`

**Topics**
+ [使用 Amazon CLI 列出标签](#Tagging.Managing.CLI.List)
+ [使用 Amazon CLI 添加标签](#Tagging.Managing.CLI.Add)
+ [使用 Amazon CLI 修改标签](#Tagging.Managing.CLI.Modify)
+ [使用 Amazon CLI 删除标签](#Tagging.Managing.CLI.Remove)

## 使用 Amazon CLI 列出标签
<a name="Tagging.Managing.CLI.List"></a>

您可以使用 Amazon CLI 通过 [list-tags-for-resource](https://docs.amazonaws.cn/cli/latest/reference/elasticache/list-tags-for-resource.html) 操作列出现有 ElastiCache 资源上的标签。

以下代码使用 Amazon CLI 列出 us-west-2 区域中的 Memcached 集群 `my-cluster` 上的标签。

对于 Linux、macOS 或 Unix：

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

对于 Windows：

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

以下代码使用 Amazon CLI 列出 us-west-2 区域中 `my-cluster-001` 集群中的 Valkey 或 Redis OSS 节点上的标签。

对于 Linux、macOS 或 Unix：

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

对于 Windows：

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

此操作的输出类似于下文，即列出资源上的所有标签。

```
{
   "TagList": [
      {
         "Value": "10110",
         "Key": "CostCenter"
      },
      {
         "Value": "EC2",
         "Key": "Service"
      }
   ]
}
```

如果资源上没有任何标签，则输出空标签列表。

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

有关更多信息，请参阅适用于 ElastiCache 的 Amazon CLI ([list-tags-for-resource](https://docs.amazonaws.cn/cli/latest/reference/elasticache/list-tags-for-resource.html))。

## 使用 Amazon CLI 添加标签
<a name="Tagging.Managing.CLI.Add"></a>

您可以使用 Amazon CLI 通过 [add-tags-to-resource](https://docs.amazonaws.cn/cli/latest/reference/elasticache/add-tags-to-resource.html) CLI 操作向现有 ElastiCache 资源添加标签。如果资源上不存在标签键，则键和值将添加到资源。如果资源上已存在该键，则与该键关联的值将更新为新值。

下面的代码使用 Amazon CLI 向 us-west-2 区域中集群 `my-cluster` 的节点 `my-cluster-001` 添加键 `Service` 和 `Region`，这两个键的值分别为 `elasticache` 和 `us-west-2`。

**Memcached**

对于 Linux、macOS 或 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
```

对于 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**

对于 Linux、macOS 或 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
```

对于 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
```

此操作的输出将类似于下文，先列出资源上的所有标签，后面跟随操作。

```
{
   "TagList": [
      {
         "Value": "elasticache",
         "Key": "Service"
      },
      {
         "Value": "us-west-2",
         "Key": "Region"
      }
   ]
}
```

有关更多信息，请参阅适用于 ElastiCache 的 Amazon CLI ([add-tags-to-resource](https://docs.amazonaws.cn/cli/latest/reference/elasticache/add-tags-to-resource.html))。

还可以在创建新集群时使用 Amazon CLI 向集群添加标签，方法是使用操作 [create-cache-cluster](https://docs.amazonaws.cn/cli/latest/reference/elasticache/create-cache-cluster.html)。使用 ElastiCache 管理控制台创建集群时，您不能添加标签。创建集群之后，随后可以使用控制台向集群添加标签。

## 使用 Amazon CLI 修改标签
<a name="Tagging.Managing.CLI.Modify"></a>

您可以使用 Amazon CLI 修改 ElastiCache 集群上的标签。

修改标签：
+ 使用 [add-tags-to-resource](https://docs.amazonaws.cn/cli/latest/reference/elasticache/add-tags-to-resource.html) 可添加新标签和值，或更改与现有标签关联的值。
+ 使用 [remove-tags-from-resource](https://docs.amazonaws.cn/cli/latest/reference/elasticache/remove-tags-from-resource.html) 删除资源的指定标签。

以上任意操作的输出将是指定集群上标签及其值的列表。

## 使用 Amazon CLI 删除标签
<a name="Tagging.Managing.CLI.Remove"></a>

您可以使用 Amazon CLI 通过 [remove-tags-from-resource](https://docs.amazonaws.cn/cli/latest/reference/elasticache/remove-tags-from-resource.html) 操作删除现有 ElastiCache for Memcached 集群的标签。

对于 Memcached，下面的代码使用 Amazon CLI 移除了 us-west-2 区域中集群 `my-cluster` 的节点 `my-cluster-001` 包含的键 `Service` 和 `Region` 的标签。

对于 Linux、macOS 或 Unix：

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

对于 Windows：

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

对于 Redis OSS，下面的代码使用 Amazon CLI 移除了 us-west-2 区域中集群 `my-cluster` 的节点 `my-cluster-001` 包含的键 `Service` 和 `Region` 的标签。

对于 Linux、macOS 或 Unix：

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

对于 Windows：

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

此操作的输出将类似于下文，先列出资源上的所有标签，后面跟随操作。

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

有关更多信息，请参阅适用于 ElastiCache 的 Amazon CLI ([remove-tags-from-resource](https://docs.amazonaws.cn/cli/latest/reference/elasticache/remove-tags-from-resource.html))。