接口说明
该接口用于批量退订云主机。
- 批量退订最大支持50台
- RAM用户批量操作数量限制10台
- 仅支持单虚机退订,不支持一体化退订
- 接口限流:调用该接口每个用户每秒限3次
URL
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/batch/delete
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
serverBatchReq
|
ServerBatchDeleteReq
|
是
|
批量退订请求体。 |
|
serverIds
|
<string> array
|
是
|
主机ID数组。 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/batch/delete
{
"serverIds":[
"6a67d90c-4dc1-444f-8c18-c1eb97a1536e",
"5667d90c-4dc1-444f-8c18-c1et57a1555e"
]
}
返回参数
返回码:200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
ServerBatchDeleteResp
|
请求成功时返回的数据 |
|
serverBatchResult
|
<ActionResult> array
|
云主机批量退订结果集 |
|
failReason
|
string
|
失败原因 |
|
result
|
boolean
|
操作是否下发成功 |
|
serverId
|
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
{
"serverBatchResult":[
{
"serverId":"6a67d90c-4dc1-444f-8c18-c1eb97a1536e",
"result":false,
"failReason":"reason"
},
{
"serverId":"5667d90c-4dc1-444f-8c18-c1et57a1555e",
"result":false,
"failReason":"reason"
}
]
}