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