调用ListTagResources查询指定资源已绑定的标签列表。
接口说明
请求中至少指定一个参数:ResourceId.N、Tag.N.Key或者Tag.N.Value,以确定查询对象。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagResources |
系统规定参数。取值:ListTagResources。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。 |
ResourceType | String | 是 | ALIYUN::GWS::INSTANCE |
资源类型。目前仅支持云桌面,取值为:ALIYUN::GWS::INSTANCE。 |
ResourceId.N | RepeatList | 否 | ecd-ia2zw38bi6cm7**** |
资源ID,即云桌面ID。N的取值范围:1~50。 |
Tag.N.Key | String | 否 | TestKey |
标签键。N的取值范围:1~20。 |
Tag.N.Value | String | 否 | TestValue |
标签值。N的取值范围:1~20。 |
MaxResults | Integer | 否 | 10 |
分页查询时每页行数。 |
NextToken | String | 否 | caeba0bbb2be03f84eb48b699f0a4883 |
下一个查询开始Token。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | caeba0bbb2be03f84eb48b699f0a4883 |
下一个查询开始Token。 |
RequestId | String | 484256DA-D816-44D2-9D86-B6EE4D5BA78C |
请求ID。 |
TagResources | Array of TagResource |
资源及其标签信息集合。 |
|
ResourceId | String | ecd-ia2zw38bi6cm7**** |
资源ID,即云桌面ID。 |
ResourceType | String | ALIYUN::GWS::INSTANCE |
资源类型。目前仅支持云桌面,取值为:ALIYUN::GWS::INSTANCE。 |
TagKey | String | TestKey |
标签键。 |
TagValue | String | TestValue |
标签值。 |
示例
请求示例
https://ecd.cn-hangzhou.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=ALIYUN::GWS::INSTANCE
&<公共请求参数>
正常返回示例
XML
格式
<ListTagResourcesResponse>
<NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
<RequestId>484256DA-D816-44D2-9D86-B6EE4D5BA78C</RequestId>
<TagResources>
<ResourceId>ecd-ia2zw38bi6cm7****</ResourceId>
<TagKey>TestKey</TagKey>
<ResourceType>ALIYUN::GWS::INSTANCE</ResourceType>
<TagValue>TestValue</TagValue>
</TagResources>
</ListTagResourcesResponse>
JSON
格式
{
"NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
"RequestId": "484256DA-D816-44D2-9D86-B6EE4D5BA78C",
"TagResources": [{
"ResourceId": "ecd-ia2zw38bi6cm7****",
"TagKey": "TestKey",
"ResourceType": "ALIYUN::GWS::INSTANCE",
"TagValue": "TestValue"
}]
}
错误码
访问错误中心查看更多错误码。