查询资源标签
调用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
}
- 本页导读 (0)