接口说明
本接口提供专属宿主机批量解绑标签的功能。
URL
POST https://ecloud.10086.cn/api/openapi-ddh/customer/v3/dedicatedHost/cloudApi/v2/host/tags/unbind
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
unbindDedicatedHostTagReq
|
UnbindDedicatedHostTagReq
|
是
|
专属宿主机批量解绑标签请求体 |
|
dedicatedHostIds
|
<string> array
|
是
|
专属宿主机ID列表 |
|
tagIds
|
<string> array
|
是
|
标签ID列表 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ddh/customer/v3/dedicatedHost/cloudApi/v2/host/tags/unbind{
"dedicatedHostIds":[
"id1",
"id2"
],
"tagIds":[
"tagId1"
]
}返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
UnbindServersTagResp
|
专属宿主机批量解绑标签返回体 |
|
tagIds
|
<string> array
|
标签ID列表 |
|
unbindFailedDedicatedHosts
|
<UnbindFailedDedicatedHost> array
|
未成功解绑的专属宿主机信息集合 |
|
dedicatedHost
|
string
|
未成功解绑的专属宿主机ID |
|
message
|
string
|
未成功解绑的原因 |
|
unbindSuccessDedicatedHosts
|
<string> array
|
已解绑的专属宿主机ID列表 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码;返回正常：OK,返回错误：ERROR,返回异常：EXCEPTION,需要告警实现的：ALARM,禁止访问：FORBIDDEN |
返回示例
返回码：200
OK
{
"body":{
"tagIds":[
"tagId1"
],
"unbindFailedDedicatedHosts":[
{
"dedicatedHost":"id1",
"message":"message"
}
],
"unbindSuccessDedicatedHosts":[
"id2"
]
},
"requestId":"reqId1",
"state":"OK"
}