查詢指定標簽鍵對應的標簽值。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
tag:ListTagValues | Read |
|
| 無 |
tag:ListTagValues | Read |
|
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 地域 ID。 關于地域 ID 的詳情,請參見服務接入點。 | cn-hangzhou |
Key | string | 是 | 標簽鍵,用于查詢的過濾條件。 | k1 |
NextToken | string | 否 | 下一個查詢開始的 Token。 | caeba0bbb2be03f84eb48b699f0a**** |
PageSize | integer | 否 | 分頁時每頁顯示的標簽值個數。 最大值:1000。默認值:50。 | 50 |
ResourceType | string | 否 | 資源類型,用于查詢的過濾條件。 格式:
| ALIYUN::ECS::INSTANCE |
QueryType | string | 否 | 標簽類型,用于查詢的過濾條件。取值:
說明
取值不區分大小寫。
| ResourceTag |
FuzzyType | string | 否 | 模糊查詢類型。取值:
說明
該參數僅支持華南 1(深圳)和中國(香港)地域。
| EQUAL |
TagFilter.Value | string | 否 | 模糊查詢的標簽值。 該參數與 說明
該參數僅支持華南 1(深圳)和中國(香港)地域。
| 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. | 預置標簽Key不存在。 |
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. | 標簽鍵參數不可為空。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|
暫無變更歷史