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

# 编辑与 KMS 密钥关联的标签
<a name="edit-tags"></a>

标签有助于识别和整理您的 AWS 资源。您可以在 AWS KMS 控制台中或使用[TagResource](https://docs.aws.amazon.com/kms/latest/APIReference/API_TagResource.html)操作来编辑与客户托管的 KMS 密钥关联的标签。您无法编辑的标签 AWS 托管式密钥。

以下过程演示如何编辑与 KMS 密钥关联的标签。 AWS KMS API 示例使用 [AWS Command Line Interface （AWS CLI）](https://aws.amazon.com/cli/)，但您可以使用任何受支持的编程语言。

## 使用控制 AWS KMS 台
<a name="edit-tag-console"></a>

1. 登录 AWS 管理控制台 并在 [https://console.aws.amazon.com/km](https://console.aws.amazon.com/kms) s 处打开 AWS Key Management Service (AWS KMS) 控制台。

1. 要更改 AWS 区域，请使用页面右上角的区域选择器。

1. 在导航窗格中，选择**客户托管密钥**。（您无法编辑的标签 AWS 托管式密钥）

1. 您可以使用表筛选条件仅显示带有特定标签的 KMS 密钥。有关详细信息，请参阅[使用 AWS KMS 控制台查看标签](view-tags.md#view-tag-console)。

1. 选中 KMS 密钥的别名旁的复选框。

1. 选择 **Key actions**、**Add or edit tags**。

1. 在 KMS 密钥的详细信息页面上，选择 **Tags**（标签）选项卡。
   + 要更改标签的名称或值，请选择 **Edit (编辑)**，进行更改，然后选择 **Save (保存)**。

1. 要保存您的更改，请选择**保存更改**。

## 使用 AWS KMS API
<a name="tag-existing-api"></a>

该[TagResource](https://docs.aws.amazon.com/kms/latest/APIReference/API_TagResource.html)操作向客户托管密钥添加一个或多个标签；。但是，您也可以使用 **TagResource** 来更改现有标签的标签值。此操作不能用于添加或编辑不同 AWS 账户中的标签。

要编辑标签，请指定现有标签键和新标签值。KMS 密钥上的每个标签都必须具有不同的标签键。标签值可为 null 或空字符串。

例如，此命令会将 `Purpose` 标签的值从 `Pretest` 更改为 `Test`。

```
$ aws kms tag-resource \
         --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
         --tags TagKey=Purpose,TagValue=Test
```