本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 ElastiCache API 管理成本配置標籤
<a name="Tagging.Managing.API"></a>

您可以使用 ElastiCache API 來新增、修改或移除成本配置標籤。

成本配置標籤會套用至 ElastiCache for Memcached 叢集。要加標籤的叢集是使用 ARN (Amazon Resource Name) 來指定。

範例 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，將含有索引鍵 `Service` 和 `Region` 的標籤從 us-west-2 區域中 `my-cluster` 叢集裡的 `my-cluster-001` 節點移除。

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