接口说明
将实例加入回收站（支持批量）。回收站内实例保留7天，如7天内未进行实例恢复，系统彻底删除资源。如：4月20日19:00:00加入回收站，4月27日19:00:00 资源彻底删除。
接口约束：
- 一次最多操作 10 台实例加入回收站，互联网用户不支持批量操作。
- 仅支持云主机及对应系统盘加入回收站，如果实例绑定数据盘、公网 IP、云存储网关等资源则不允许加入回收站。
- 回收站中实例恢复时，存在因资源不足而无法恢复的风险，请谨慎操作。
- 处于实例退订保护的云主机无法加入回收站。
- 如云主机自动退订时间不足七天，需取消自动退订后再加入回收站。
- 同一实例仅允许加入回收站3次。
- 每个资源池回收站内实例限制20个，如超出需要退订回收站内资源。
- 以下类型不支持加入回收站：FPGA型、高IO型、突发性能型。
- 已冻结的云主机不支持加入回收站。
URL
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/recycleBin/add
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
batchActionReq
|
BatchActionReq
|
是
|
batchActionReq |
|
instanceIds
|
<string> array
|
是
|
【必填】实例ID数组。 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/recycleBin/add{
"instanceIds":[
"86380653-***-d64f4b013361"
]
}返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
BatchAction«ServerActionResult»
|
请求成功时返回的数据。 |
|
serverBatchResult
|
<ServerActionResult> array
|
实例批量操作结果集。 |
|
instanceId
|
string
|
实例ID。 |
|
result
|
boolean
|
操作是否下发成功。 |
|
message
|
string
|
操作结果信息，失败时返回错误信息，成功时返回空字符串。 |
|
errorCode
|
string
|
统一错误码。 |
|
errorMessage
|
string
|
页面国际化错误提示。 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数。 |
|
requestId
|
string
|
每个请求的序列号。 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码。返回正常：OK，返回错误：ERROR，返回异常：EXCEPTION，需要告警实现的：ALARM，禁止访问：FORBIDDEN。 |
返回示例
返回码：200
OK
{
"body":{
"serverBatchResult":[
{
"instanceId":"86380653-***-d64f4b013361",
"result":"true",
"message":null
}
]
},
"requestId":"reqId-ac15c7d9-***-451a042af366",
"state":"OK"
}