View a markdown version of this page

資源群組使用 標記 API 範例 AWS CLI - AWS Command Line Interface
動作

本文件 AWS CLI 僅適用於 第 1 版。

我們已宣布即將end-of-support。 AWS CLI 我們建議您遷移至 第 2 AWS CLI 版。如需日期、其他詳細資訊和如何遷移的資訊，請參閱 公告。如需 第 2 版的相關文件 AWS CLI，請參閱 第 2 版使用者指南。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

資源群組使用 標記 API 範例 AWS CLI

下列程式碼範例示範如何使用 AWS Command Line Interface 搭配資源群組標記 API 來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。

每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。

主題

動作

以下程式碼範例顯示如何使用 get-resources。

AWS 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 詳細資訊，請參閱《AWS CLI 命令參考》中的 GetResources。

以下程式碼範例顯示如何使用 get-tag-keys。

AWS CLI

取得所有標籤索引鍵的清單

下列 get-tag-keys 範例會擷取帳戶中資源使用的所有標籤索引鍵名稱清單。

aws resourcegroupstaggingapi get-tag-keys

輸出：

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

如需詳細資訊，請參閱《資源群組標記 API 參考》中的 GetTagKeys。

  • 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》中的 GetTagKeys。

以下程式碼範例顯示如何使用 get-tag-values。

AWS CLI

取得所有標籤值的清單

下列 get-tag-values 範例顯示其中所有資源的指定索引鍵所使用的所有值

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

輸出：

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

如需詳細資訊，請參閱《資源群組標記 API 參考》中的 GetTagValues。

  • 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》中的 GetTagValues。

以下程式碼範例顯示如何使用 tag-resources。

AWS CLI

將標籤連接至資源

下列 tag-resources 範例會使用索引鍵名稱和值來標記指定的資源。

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

輸出：

{
    "FailedResourcesMap": {}
}

如需詳細資訊，請參閱《資源群組標記 API 參考》中的 TagResources。

  • 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》中的 TagResources。

以下程式碼範例顯示如何使用 untag-resources。

AWS 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 詳細資訊，請參閱《AWS CLI 命令參考》中的 UntagResources。