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

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

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作

操作	访问级别	资源类型	条件关键字	关联操作
cddc:ListTagResources	get	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值

名称	类型	必填	描述	示例值
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>	主机和标签的信息。
TagResources	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	错误码	错误信息	描述

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.	-

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

变更历史

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

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

暂无变更历史