全部產品
Search

搜尋本產品

    Resource Management：ListTagValues - 查詢指定標籤鍵對應的標籤值

    文件中心

    Resource Management：ListTagValues - 查詢指定標籤鍵對應的標籤值

    更新時間：Feb 25, 2026

    查詢指定標籤鍵對應的標籤值。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    tag:ListTagValues

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地區 ID。

    關於地區 ID 的詳情，請參見服務存取點。

    cn-hangzhou
    RegionId

    string

    是

    地區 ID。

    關於地區 ID 的詳情，請參見服務存取點。

    cn-hangzhou
    Key

    string

    是

    標籤鍵，用於查詢的過濾條件。

    k1
    NextToken

    string

    否

    下一個查詢開始的 Token。

    caeba0bbb2be03f84eb48b699f0a****
    PageSize

    integer

    否

    分頁時每頁顯示的標籤值個數。

    最大值：1000。預設值：50。

    50
    ResourceType

    string

    否

    資源類型，用於查詢的過濾條件。

    格式：ALIYUN::${ProductCode}::${ResourceType}，全部大寫。

    ALIYUN::ECS::INSTANCE
    QueryType

    string

    否

    標籤類型，用於查詢的過濾條件。取值：

    • ResourceTag（預設值）：資源標籤。包括自訂標籤和系統標籤。

    • MetaTag：預置標籤。

    說明

    取值不區分大小寫。

    ResourceTag
    FuzzyType

    string

    否

    模糊查詢類型。取值：

    • EQUAL（預設值）：精確查詢。

    • PREFIX：根據首碼進行模糊查詢。

    EQUAL
    TagFilter.Value

    string

    否

    模糊查詢的標籤值。

    該參數與FuzzyType配合使用。

    v1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    NextToken

    string

    根據NextToken判斷是否具備下一個查詢開始的 Token。取值：

    • 如果NextToken為空白，即"NextToken": ""，表示沒有下一個。

    • 如果NextToken有值，則該值就是下一個查詢開始的 Token。

    caeba0bbb2be03f84eb48b699f0a****
    RequestId

    string

    請求 ID。

    8989CA7E-D2E0-4B6D-8282-311106E80150
    Values

    object

    Value

    array

    標籤值列表。

    string

    標籤值資訊。

    v1

    樣本

    正常返回樣本

    JSON格式

    {
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "RequestId": "8989CA7E-D2E0-4B6D-8282-311106E80150",
  "Values": {
    "Value": [
      "v1"
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 FuzzyQuery.NotSupport The fuzzy query is not supported.
    403 Invalid.NextToken The parameter NextToken is invalid. NextToken參數非法。
    403 NoPermission.Operator The user is not authorized to operate on the specified resource. 該使用者沒有許可權操作。
    403 NoPermissionKey.Operator You are not authorized to operate the tag key. 該使用者沒有操作此標籤鍵許可權。
    403 InvalidParameter.ResourceType The ResourceType parameter is invalid. 資源型別參數非法。
    403 InvalidParameter.TagKey The Tag.N.Key parameter is invalid. 標籤鍵參數非法。
    403 MetaTagKeyNotFound The meta tag key is not found. 預置標籤鍵不存在。
    404 Missing.TagKey Tag.N.Value has been specified and you must specify Tag.N.Key. 一對索引值對，對應的TagValue缺失相同N的TagKey。
    404 MissingParameter.TagKey You must specify TagKey. 標籤鍵參數不可為空白。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。