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

本文档仅适用于 Amazon CLI 版本 1。有关 Amazon CLI 版本 2 的相关文档，请参阅版本 2 用户指南。

使用 Amazon CLI 的资源组标记 API

以下代码示例演示了如何通过将 Amazon Command Line Interface与资源组标记 API 结合使用，来执行操作和实现常见场景。

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

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

主题

操作

以下代码示例演示了如何使用 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"
                }
            ]
        }
    ]
}

有关更多信息，请参阅《资源组标记 API 参考》中的 GetResources。

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

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

Amazon CLI

获取所有标签键的列表

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

aws resourcegroupstaggingapi get-tag-keys

输出：

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

有关更多信息，请参阅《资源组标记 API 参考》中的 GetTagKeys。

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

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

Amazon CLI

获取所有标签值的列表

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

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

输出：

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

有关更多信息，请参阅《资源组标记 API 参考》中的 GetTagValues。

  • 有关 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": {}
}

有关更多信息，请参阅《资源组标记 API 参考》中的 TagResources。

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

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

Amazon CLI

从资源中删除标签

以下 untag-resources 示例将从指定资源中删除指定的标签键及其关联的值。

aws resourcegroupstaggingapi untag-resources \
    --resource-arn-list arn:aws:s3:::amzn-s3-demo-bucket \
    --tag-keys Environment CostCenter

输出：

{
    "FailedResourcesMap": {}
}

有关更多信息，请参阅《资源组标记 API 参考》中的 UntagResources。

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