调用ListTagResources查询一个或多个SMC资源(迁移源和迁移任务)已经绑定的标签列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagResources |
系统规定参数。取值:ListTagResources。 |
ResourceType | String | 是 | sourceserver |
SMC资源类型。取值范围:
|
NextToken | String | 否 | caeba0bbb2be03f84eb48b699f0a4883 |
下一个查询开始Token。 |
ResourceId.N | String | 否 | s-bp1e2fsl57knvuug**** |
SMC资源ID。SMC资源包括迁移源和迁移任务 |
Tag.N.Key | String | 否 | TestKey |
SMC资源的标签键。标签键长度的取值范围:1~64。N的取值范围:1~20。 Tag.N用于精确查找绑定了指定标签的SMC资源,由一个键值对组成。
|
Tag.N.Value | String | 否 | TestValue |
SMC资源的标签值。标签值长度的取值范围:1~64。N的取值范围:1~20。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | caeba0bbb2be03f84eb48b699f0a4883 |
下一个查询开始Token。 NextToken为空,说明当页已显示完所有信息。 |
RequestId | String | 17743161-66F3-4E7F-B8AE-845FB28B928F |
请求ID。 |
TagResources | Array of TagResource |
由SMC资源及其标签组成的集合,包含了资源ID、资源类型和标签键值等信息。 |
|
TagResource | |||
ResourceType | String | ALIYUN::SMC::SOURCESERVER |
资源类型。 |
TagValue | String | TestValue |
资源的标签值。 |
ResourceId | String | s-bp1e2fsl57knvuug**** |
资源ID。 |
TagKey | String | TestKey |
资源的标签键。 |
示例
请求示例
http(s)://smc.aliyuncs.com/?Action=ListTagResources
&ResourceType=sourceserver
&NextToken=caeba0bbb2be03f84eb48b699f0a4883
&ResourceId=["s-bp1e2fsl57knvuug****"]
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListTagResourcesResponse>
<NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
<RequestId>17743161-66F3-4E7F-B8AE-845FB28B928F</RequestId>
<TagResources>
<ResourceType>ALIYUN::SMC::SOURCESERVER</ResourceType>
<TagValue>TestValue</TagValue>
<ResourceId>s-bp1e2fsl57knvuug****</ResourceId>
<TagKey>TestKey</TagKey>
</TagResources>
</ListTagResourcesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
"RequestId" : "17743161-66F3-4E7F-B8AE-845FB28B928F",
"TagResources" : [ {
"ResourceType" : "ALIYUN::SMC::SOURCESERVER",
"TagValue" : "TestValue",
"ResourceId" : "s-bp1e2fsl57knvuug****",
"TagKey" : "TestKey"
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | NumberExceed.Tags | The maximum number of the Tag parameters cannot exceed 20. | 标签列表参数不能超过20个。 |
400 | MissingParameter.ResourceType | You must specify ResourceType. | 资源类型不能为空 |
400 | InvalidResourceType.NotFound | The specified ResourceType does not exist. | 资源类型不存在 |
400 | NumberExceed.ResourceIds | The maximum number of ResourceId parameters cannot exceed 50. | 资源ID参数不能超过50个。 |
400 | Duplicate.ResourceId | The ResourceId contains duplicate values. | 资源ID中存在重复的值。 |
400 | InvalidResourceId.NotFound | The specified ResourceIds do not exist. | 资源不存在 |
访问错误中心查看更多错误码。