接口说明
本接口用于为云主机绑定标签。
说明：
- 若标签未创建则会创建并绑定标签。
- 一台云主机最多绑定十个标签。
URL
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/tags
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
bindTagReq
|
BindTagReq
|
是
|
绑定标签请求体。 |
|
serverId
|
string
|
是
|
云主机ID，可通过主机列表详情接口获取。 |
|
tags
|
<标签键值对> array
|
是
|
标签。 |
|
key
|
string
|
是
|
标签键，仅支持数字、中英文、中划线、下划线，长度在1~127位之间，且不可重复不能以 |
|
value
|
string
|
是
|
标签值，仅支持数字、中英文、中划线、下划线，长度在1~255位之间，不能以 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/tags{
"body":{
"serverId":"4ew55752-dsab-4c95-5x7a-5abfd321f63f",
"tags":[
{
"key":"testkey",
"value":"testvalue"
}
]
}
}返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
object
|
请求成功时返回的数据 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码，返回正常：OK，返回错误：ERROR，返回异常：EXCEPTION，需要告警实现的：ALARM，禁止访问：FORBIDDEN。 |
返回示例
返回码：200
OK
{
"requestId":"reqId-271a1c5b12x15dbece31e-84b893a4-7",
"state":"OK",
"body":null
}