接口说明
本接口用于为指定的云主机资源列表创建并绑定标签。
URL
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/tags/bind
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
bindResourcesTagReq
|
BindResourcesTagReq
|
是
|
为指定的云主机资源列表创建并绑定标签请求体。 |
|
resourceIds
|
<string> array
|
是
|
资源ID列表。 |
|
resourceType
|
string
|
否
|
资源类型。取值范围：
|
|
tags
|
<TagReq> array
|
是
|
标签列表。 |
|
key
|
string
|
是
|
标签键，标签键仅支持数字、中英文、中划线、下划线，长度在1-127位之间，且不可重复不能以'ecloud'开头。 |
|
value
|
string
|
是
|
标签值，标签值仅支持数字、中英文、中划线、下划线，长度在1-255位之间，不能以'ecloud'开头。 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/tags/bind{
"resourceIds":[
"1a02780c-5c0b-494e-b967-****"
],
"tags":[
{
"key":"test-1105",
"value":"2"
},
{
"key":"test-1105",
"value":"3"
}
]
}返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
BindResourcesTagResp
|
请求成功时返回的数据 |
|
bindResources
|
<string> array
|
已绑定的资源ID列表 |
|
tagIds
|
<string> array
|
标签ID列表 |
|
unbindResources
|
<UnbindResources> array
|
未绑定的资源集合 |
|
message
|
string
|
未绑定的原因 |
|
resourceId
|
string
|
未绑定的资源ID |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码;返回正常：OK,返回错误：ERROR,返回异常：EXCEPTION,需要告警实现的：ALARM,禁止访问：FORBIDDEN |
返回示例
返回码：200
OK
{
"requestId":"req-***",
"state":"OK",
"body":{
"bindResources":[
"server1",
"server2"
],
"tagIds":[
"tag1",
"tag2"
],
"unbindResources":[
{
"resourceId":"server3",
"message":"error message"
}
]
}
}