文档

查询资源标签

更新时间:
一键部署

调用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集群,由一个键值对组成。

  • 仅指定Tag.N.Key时,则返回关联该标签键的所有集群。

  • 仅指定Tag.N.Value,则报错MissingParameter.TagKey。

  • 同时指定多个标签键值对时,仅同时满足所有标签键值对的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)
文档反馈