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

使用 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。