AWS Key Management Service
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

标记密钥

您可以添加、更改和删除客户托管 CMK 的标签。每个标签均由一个标签密钥和一个标签值组成,两者均由您定义。例如,标签密钥可能是“Cost Center”,标签值可能是“87654”。 您无法标记 AWS 托管 CMK

在将标签添加到 AWS 资源时,AWS 可生成成本分配报告,其中按标签汇总了使用情况和成本。您可以使用此功能来跟踪项目、应用程序或成本中心的 AWS KMS 成本。

有关对成本分配使用标签的更多信息,请参阅 AWS Billing and Cost Management 用户指南 中的使用成本分配标签。有关适用于标签键和标签值的规则的信息,请参阅 AWS Billing and Cost Management 用户指南 中的用户定义的标签限制

管理 CMK 标签(控制台)

您可以在 AWS 管理控制台中添加、编辑和删除客户托管 CMK 的标签。您可在创建 CMK 时为 CMK 添加标签,并随时编辑它们。您无法编辑处于等待删除状态的 CMK 的标签。有关更多信息,请参阅编辑密钥

  1. 登录 AWS 管理控制台并通过以下网址打开 AWS Key Management Service (AWS KMS) 控制台:https://console.amazonaws.cn/kms

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

  3. 在导航窗格中,选择 Customer managed keys (客户托管密钥)。(您无法管理 AWS 托管 CMK 的标签。)

  4. 选中 CMK 的别名旁的复选框。

  5. 选择 Key actionsAdd or edit tags

  6. 使用控件添加、编辑或删除标签。标签名称在账户和区域中必须是唯一的。

  7. 要保存您的更改,请选择 Save Changes (保存更改)

管理 CMK 标签(KMS API)

您可以使用 AWS Key Management Service (AWS KMS) API 为您管理的 CMK 添加、删除和列出标签。这些示例使用 AWS Command Line Interface (AWS CLI),但您可以使用任何受支持的编程语言。

您无法标记 AWS 托管 CMK。

TagResource:为 CMK 添加或更改标签

TagResource 操作会向 CMK 添加一个或多个标签。

您也可以使用 TagResource 来更新现有标签的值。要替换标签值,请指定具有不同值的相同标签键。要向标签添加值,请指定既有新值又有现有值的标签键。

例如,这个对 TagResource 操作的调用会向指定的 CMK 添加 PurposeDepartment 标签。您可以使用任何键和值作为 CMK 标签。

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

此命令成功执行后,不会返回任何输出。要查看 CMK 上的标签,请使用 ListResourceTags 操作。

ListResourceTags:获取 CMK 的标签

ListResourceTags 操作会获取 CMK 的标签。key-id 参数是必需的。

例如,以下命令获取指定 CMK 的标签。

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

UntagResource:从 CMK 中删除标签

UntagResource 操作会从 CMK 中删除标签。key-idtag-keys 参数是必需的。

例如,此命令将从指定的 CMK 中删除 Purpose 标签及其所有值。

$ aws kms untag-resource --tag-keys Purpose --key-id 1234abcd-12ab-34cd-56ef-1234567890ab

此命令成功执行后,不会返回任何输出。