Resource Groups 使用标记 API 示例 Amazon CLI - Amazon Command Line Interface
操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Resource Groups 使用标记 API 示例 Amazon CLI

以下代码示例向您展示了如何使用 with Resource Groups Tagging API 来执行操作和实现常见场景。 Amazon Command Line Interface

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景和跨服务示例的上下文查看操作。

场景是展示如何通过在同一服务中调用多个函数来完成特定任务任务的代码示例。

每个示例都包含一个指向的链接 GitHub，您可以在其中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示如何使用 get-resources。

Amazon CLI

获取已标记资源的列表

以下get-resources示例显示账户中使用指定密钥名称和值标记的资源列表。

aws resourcegroupstaggingapi get-resources \
    --tag-filters Key=Environment,Values=Production \
    --tags-per-page 100

输出：

{
    "ResourceTagMappingList": [
        {
            "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}

有关更多信息，请参阅 Resour GetResourcesce G roups 标记 API 参考中的。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考GetResources中的。

以下代码示例演示如何使用 get-tag-keys。

Amazon CLI

获取所有标签键的列表

以下get-tag-keys示例检索账户中资源使用的所有标签密钥名称的列表。

aws resourcegroupstaggingapi get-tag-keys

输出：

{
    "TagKeys": [
        "Environment",
        "CostCenter",
        "Department"
    ]
}

有关更多信息，请参阅 Resour GetTagKeysce G roups 标记 API 参考中的。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考GetTagKeys中的。

以下代码示例演示如何使用 get-tag-values。

Amazon CLI

获取所有标签值的列表

以下get-tag-values示例显示了所有资源中用于指定密钥的所有值

aws resourcegroupstaggingapi get-tag-values \
    --key=Environment

输出：

{
    "TagValues": [
        "Alpha",
        "Gamma",
        "Production"
    ]
}

有关更多信息，请参阅 Resour GetTagValuesce G roups 标记 API 参考中的。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考GetTagValues中的。

以下代码示例演示如何使用 tag-resources。

Amazon CLI

为资源附加标签

以下tag-resources示例使用密钥名称和值对指定资源进行标记。

aws resourcegroupstaggingapi tag-resources \
    --resource-arn-list arn:aws:s3:::MyProductionBucket \
    --tags Environment=Production,CostCenter=1234

输出：

{
    "FailedResourcesMap": {}
}

有关更多信息，请参阅 Resour TagResourcesce G roups 标记 API 参考中的。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考TagResources中的。

以下代码示例演示如何使用 untag-resources。

Amazon CLI

从资源中移除标签

以下untag-resources示例从指定资源中删除指定的标签键和任何关联值。

aws resourcegroupstaggingapi untag-resources \
    --resource-arn-list arn:aws:s3:::awsexamplebucket \
    --tag-keys Environment CostCenter

输出：

{
    "FailedResourcesMap": {}
}

有关更多信息，请参阅 Resour UntagResourcesce G roups 标记 API 参考中的。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考UntagResources中的。