ListTagResources - 调用 ListTagResources 查询主机和标签的绑定关系_云数据库专属集群(MyBase)-阿里云帮助中心

查询主机和标签的绑定关系。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	主机所属的地域 ID。	ap-southeast-1
ResourceType	string	是	资源类型，取值固定为 DEDICATEDHOST。	DEDICATEDHOST
ResourceId	array	否	主机 ID，可以设置多个。
	string	否	主机 ID，可以设置多个。 N 表示窜入第几个主机 ID。例如： Resourceid.1表示传入第一个主机 ID。 Resourceid.2表示传入第二个主机 ID。	ch-t4n4dcdvu6840****
Tag	array<object>	否	标签。
	object	否
Key	string	否	标签的键。 N 表示传入第几个标签的键。例如： Tag.1.Key表示传入第一个标签的键。 Tag.2.Key表示传入第二个标签的键。本参数和ResourceId.N参数两者中必须传入一项。	demokey
Value	string	否	标签的值。 N 表示传入第几个标签的值。例如： Tag.1.Value表示传入第一个标签的值。 Tag.2.Value表示传入第二个标签的值。如果标签的值不存在，则自动创建。	demovalue

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	2853CAA0-D7A2-5CAB-B3A8-BDE2994F320C
TagResources	array<object>	主机和标签的信息。
	object	主机和标签的信息。
TagValue	string	标签的值。	demovalue
ResourceType	string	资源类型。返回值固定为 ALIYUN::CDDC::DEDICATEDHOST，即阿里云专属集群主机。	ALIYUN::CDDC::DEDICATEDHOST
ResourceId	string	主机 ID。	ch-t4n4dcdvu6840****
TagKey	string	标签的键。	demokey

示例

正常返回示例

JSON格式

{
  "RequestId": "2853CAA0-D7A2-5CAB-B3A8-BDE2994F320C",
  "TagResources": [
    {
      "TagValue": "demovalue",
      "ResourceType": "ALIYUN::CDDC::DEDICATEDHOST",
      "ResourceId": "ch-t4n4dcdvu6840****",
      "TagKey": "demokey"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	MissingResourceType	The specified parameter ResourceType is not valid.	-
400	MissParameter.TagOrResourceId	The parameter Tag.n or ResourceId.n is needed.	-
400	InvalidParameter.TagValue	The Tag.%s.Value parameter - %s is invalid	标签值参数非法，不能为空，或者长度超过128。
400	InvalidParameter.TagKey	The Tag.%s.Key parameter - %s is invalid	标签键参数非法，不能为空，或者长度超过128。
400	NumberExceed.ResourceIds	The ResourceIds parameter's number is exceed , Valid : 50	-
400	InvalidTagValue.Malformed	The specified parameter "Tag.n.Value" is not valid.	-
400	InvalidDedicatedHostId.NotFound	The parameter - ResourceIds.N is not found.	资源ID对应的资源无法找到。
400	InvalidParameter.ResourceType	The specified parameter "ResourceType" is not valid.	-
400	NumberExceed.Tags	The Tags parameter's number is exceed, Valid : 20.	-
400	MissingParameter.ResourceIds	The parameter - ResourceIds.N should not be null.	资源ID列表不能为空
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	-
400	InvalidTagKey.Malformed	The Tag.N.Key parameter is invalid.	-

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史