调用TagResources为指定的SMC资源(迁移源和迁移任务)列表统一创建并绑定标签。
接口说明
每个SMC资源可绑定的标签限额为20。
绑定标签前,阿里云会校验资源已有标签数量,超过限额后返回报错信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | TagResources |
系统规定参数。取值:TagResources |
ResourceId.N | RepeatList | 是 | s-bw526m1vi6x20c6g**** |
SMC资源ID。SMC资源包括迁移源和迁移任务。N的取值范围:1~50 |
ResourceType | String | 是 | sourceserver |
SMC资源类型。取值范围:
|
Tag.N.Key | String | 否 | TestKey |
为SMC资源指定的标签键。N的取值范围:1~20 一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以aliyun和acs:开头,不能包含http://或者https://。 |
Tag.N.Value | String | 否 | TestValue |
为SMC资源指定的标签值。N的取值范围:1~20 一旦传入该值,可以为空字符串。最多支持128个字符,不能包含http://或者https://。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 3E8B9ABB-289A-44E6-942D-8AA9E4937208 |
请求ID。 |
示例
请求示例
https://smc.aliyuncs.com/?Action=TagResoruces
&RegionId=cn-hangzhou
&ResourceId.1=s-bw526m1vi6x20c6g****
&ResourceType=sourceserver
&Tag.1.Key=TestKey
&<公共请求参数>
正常返回示例
XML
格式
<TagResourcesResponse>
<RequestId>3E8B9ABB-289A-44E6-942D-8AA9E4937208</RequestId>
</TagResourcesResponse>
JSON
格式
{
"RequestId": "3E8B9ABB-289A-44E6-942D-8AA9E4937208"
}
错误码
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. | 资源ID不存在。 |
访问错误中心查看更多错误码。