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

# 查看与 KMS 密钥关联的标签
<a name="view-tags"></a>

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

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

## 使用控制 AWS KMS 台
<a name="view-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 密钥。

   要仅显示具有特定标签的 KMS 密钥，请选择筛选框，选择标签键，然后从实际标签值中进行选择。还可以键入全部或部分标签值。

   生成的表格将显示带有所选标签的所有 KMS 密钥。但是，它不显示标签。要查看标签，请选择 KMS 密钥的密钥 ID 或别名，然后在其详细信息页面上选择 **Tags**（标签）选项卡。别名显示在 **General configuration**（常规配置）部分下。

   此筛选条件同时需要标签键和标签值。它不会通过仅键入标签键或仅键入标签值来找到 KMS 密钥。要按全部或部分标签键或值筛选标签，请使用[ListResourceTags](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListResourceTags.html)操作获取带标签的 KMS 密钥，然后使用您的编程语言的筛选功能。

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

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

1. 在 KMS 密钥的详细信息页面上，选择 **Tags**（标签）选项卡。

## 使用 AWS KMS API
<a name="tagging-keys-list-resource-tags"></a>

该[ListResourceTags](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListResourceTags.html)操作获取 KMS 密钥的标签。`KeyId` 参数是必需的。此操作不能用于查看其他 AWS 账户中的 KMS 密钥上的标签。

例如，以下命令获取示例 KMS 密钥的标签。

```
$ aws kms list-resource-tags --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
       
  "Truncated": false,
  "Tags": [
      {
        "TagKey": "Project",
        "TagValue": "Alpha"
     },
     {
       "TagKey": "Purpose",
       "TagValue": "Test"
     },
     {
       "TagKey": "Department",
       "TagValue": "Finance"
     }
  ]
}
```