調用ListTagResources,查詢一個或多個Databricks集群已綁定的標簽列表,或者根據一組標簽查詢被改組標簽綁定的資源。
調用該接口時注意以下信息:
請求中至少指定一個參數:ResourceId.N、Tag.N(Tag.N.Key與Tag.N.Value),以確定查詢對象。
同時指定Tag.N和ResourceId.N時,返回結果中僅包含同時滿足這兩個條件的EMR集群。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Action | String | 否 | ListTagResource | 系統規定參數。對于您自行拼湊HTTP或HTTPS URL發起的API請求,該參數為必選參數。取值:ListTagResources。 |
RegionId | String | 是 | cn-hangzhou | 地域ID。您可以調用DescribeRegions接口查看最新的阿里云地域列表。 |
ResourceType | String | 是 | cluster | 資源類型,Databricks集群為cluster |
ResourceIds.N | String | 否 | C-3652B95F65967*** | 集群ID,您可以調用ListClusters查看集群的ID。N的取值范圍:1~50。 |
Tags.N.Key | String | 否 | TestTagKey1 | 精確查找Databricks集群時使用的標簽鍵。N的取值范圍:1~20。 Tag.N用于精確查找綁定了指定標簽的Databricks集群,由一個鍵值對組成。
|
Tags.N.Value | String | 否 | TestTagValue1 | 精確查找EMR集群時使用的標簽值。N的取值范圍:1~20。 |
返回參數
名稱 | 類型 | 示例值 | 描述 |
RequestId | String | BF4FBAC6-B03E-4BFB-B6DB-EB53C34F2E22 | 請求ID |
Success | Boolean | True | 是否成功為資源打標簽 |
Message | String | 提示信息 | |
ErrorCode | String | NumberExceed_ResourceIds | 錯誤碼 |
Data.N.ResourceId | String | C-382DX8F5***** | 集群ID |
Data.N.TagKey | String | TestTagKey1 | 集群標簽鍵 |
Data.N.ResourceType | String | CLUSTER | 資源類型 |
Data.N.TagValue | String | TestTagValue1 | 集群標簽值 |
示例
請求示例:
https://[EndPoint]/?Action=ListTagResources
&ResourceIds.1=C-837FB786******
&ResourceType=cluster
&Format=JSON
&Tags.1.Value=testTagValue2
&Tags.1.Key=testTagKey2
&RegionId=cn-hangzhou
JSON
格式:
{
"RequestId": "F3DCCB71-7EE8-1175-888F-CEAB50EDD74D",
"Data": [
{
"ResourceId": "C-837FB7867D****",
"TagKey": "testTagKey2",
"ResourceType": "cluster",
"TagValue": "testTagValue2"
}
],
"Success": true
}