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

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

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

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

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

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

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

您可以使用 ElastiCache API 通过 [ListTagsForResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ListTagsForResource.html) 操作列出现有资源上的标签。

对于 Memcached，以下代码使用 ElastiCache API 列出 us-west-2 区域中 `my-cluster` 资源上的标签。

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

对于 Redis OSS，以下代码使用 ElastiCache API 列出 us-west-2 区域中 `my-cluster-001` 资源上的标签。

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

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

您可以使用 ElastiCache API 通过 [AddTagsToResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_AddTagsToResource.html) 操作向现有 ElastiCache 集群添加标签。如果资源上不存在标签键，则键和值将添加到资源。如果资源上已存在该键，则与该键关联的值将更新为新值。

以下代码使用 ElastiCache API 添加键 `Service` 和 `Region`，其值分别为 `elasticache` 和 `us-west-2`。对于 Memcached，这将应用于资源 `my-cluster`。对于 Redis OSS，这将应用于 us-west-2 区域中的资源 `my-cluster-001`。

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

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

有关更多信息，请参阅 *Amazon ElastiCache API 参考*中的 [AddTagsToResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_AddTagsToResource.html)。

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

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

修改标签的值：
+ 使用 [AddTagsToResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_AddTagsToResource.html) 操作可添加新标签和值，或更改现有标签的值。
+ 使用 [RemoveTagsFromResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_RemoveTagsFromResource.html) 可删除资源的标签。

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

使用 [RemoveTagsFromResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_RemoveTagsFromResource.html) 可删除资源的标签。

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

您可以使用 ElastiCache API 通过 [RemoveTagsFromResource](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_RemoveTagsFromResource.html) 操作删除现有 ElastiCache for Memcached 集群的标签。

以下代码使用 ElastiCache API 从 us-west-2 区域中集群 `my-cluster` 中的节点 `my-cluster-001` 上删除具有键 `Service` 和 `Region` 的标签。

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