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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTagResources

系统规定参数。取值:ListTagResources

RegionId String ap-southeast-1

主机所属的地域ID。

ResourceType String DEDICATEDHOST

资源类型,取值固定为DEDICATEDHOST。

ResourceId.N String ch-t4n4dcdvu6840****

主机ID,可以设置多个。

N表示窜入第几个主机ID。例如:

  • Resourceid.1表示传入第一个主机ID。
  • Resourceid.2表示传入第二个主机ID。
Tag.N.Key String demokey

标签的键。

  • N表示传入第几个标签的键。例如:
    • Tag.1.Key表示传入第一个标签的键。
    • Tag.2.Key表示传入第二个标签的键。
  • 本参数和ResourceId.N参数两者中必须传入一项。
Tag.N.Value String demovalue

标签的值。

  • N表示传入第几个标签的值。例如:
    • Tag.1.Value表示传入第一个标签的值。
    • Tag.2.Value表示传入第二个标签的值。
  • 如果标签的值不存在,则自动创建。

返回数据

名称 类型 示例值 描述
RequestId String 2853CAA0-D7A2-5CAB-B3A8-BDE2994F320C

请求ID。

TagResources Array of TagResources

主机和标签的信息。

TagValue String demovalue

标签的值。

ResourceType String ALIYUN::CDDC::DEDICATEDHOST

资源类型。

返回值固定为ALIYUN::CDDC::DEDICATEDHOST,即阿里云专属集群主机。

ResourceId String ch-t4n4dcdvu6840****

主机ID。

TagKey String demokey

标签的键。

示例

请求示例

http(s)://cddc.aliyuncs.com/?Action=ListTagResources
&RegionId=ap-southeast-1
&ResourceType=DEDICATEDHOST
&ResourceId=["ch-t4n4dcdvu6840****"]
&Tag=[{"Key":"demokey","Value":"demovalue"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
    <RequestId>2853CAA0-D7A2-5CAB-B3A8-BDE2994F320C</RequestId>
    <TagResources>
        <TagValue>demovalue</TagValue>
        <ResourceType>ALIYUN::CDDC::DEDICATEDHOST</ResourceType>
        <ResourceId>ch-t4n4dcdvu6840****</ResourceId>
        <TagKey>demokey</TagKey>
    </TagResources>
</ListTagResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
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 InvalidDedicatedHostId.NotFound The parameter - ResourceIds.N is not found. 资源ID对应的资源无法找到。
400 MissingParameter.ResourceIds The parameter - ResourceIds.N should not be null. 资源ID列表不能为空

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