TagResource搭配使用 Amazon SDK或 CLI - Amazon Key Management Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

TagResource搭配使用 Amazon SDK或 CLI

以下代码示例演示如何使用 TagResource

CLI
Amazon CLI

为KMS密钥添加标签

以下tag-resource示例为客户托管KMS密钥添加"Purpose":"Test""Dept":"IT"标记。您可以使用这样的标签来标记KMS密钥并创建密KMS钥类别以进行权限和审计。

要指定KMS密钥,请使用key-id参数。此示例使用密钥 ID 值,但您可以在此命令ARN中使用密钥 ID 或密钥。

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

此命令不生成任何输出。要查看上面的标签 Amazon KMSKMSkey,使用list-resource-tags命令。

有关使用标签的更多信息,请参阅 Amazon KMS,请参阅《为密钥添加标签Amazon 密钥管理服务开发人员指南

  • 有关API详细信息,请参阅TagResource中的 Amazon CLI 命令参考

Java
SDK适用于 Java 2.x
注意

还有更多相关信息 GitHub。在中查找完整的示例,学习如何设置和运行 Amazon 代码示例存储库

/** * Asynchronously tags a KMS key with a specific tag. * * @param keyId the ID of the KMS key to be tagged * @return a {@link CompletableFuture} that completes when the tagging operation is finished */ public CompletableFuture<Void> tagKMSKeyAsync(String keyId) { Tag tag = Tag.builder() .tagKey("Environment") .tagValue("Production") .build(); TagResourceRequest tagResourceRequest = TagResourceRequest.builder() .keyId(keyId) .tags(tag) .build(); return getAsyncClient().tagResource(tagResourceRequest) .thenRun(() -> { logger.info("{} key was tagged", keyId); }) .exceptionally(throwable -> { throw new RuntimeException("Failed to tag the KMS key", throwable); }); }
  • 有关API详细信息,请参阅TagResource中的 Amazon SDK for Java 2.x API参考

有关完整列表 Amazon SDK开发者指南和代码示例,请参阅使用 Amazon KMS 用一个 Amazon SDK。本主题还包括有关入门的信息以及有关先前SDK版本的详细信息。