接口功能介绍
批量删除物理机
接口约束
- 预付费用户开通的计费类型为包周期的物理机可退订（物理机实例到期销毁）
- 物理机必须处于已停止状态（STOPPED状态）才可进行物理机删除操作，其他状态不可操作
URI
POST /v4/ebm/batch-delete
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID，您可以查看地域和可用区来了解资源池 您可以调用资源池列表查询获取最新的天翼云资源池列表 |
81f7728662dd11ec810800155d307d5b | |
| azName | 是 | String | 可用区名称，您可以查看地域和可用区来了解可用区 您可以调用资源池可用区查询 注：查询结果中zoneList内返回存在可用区名称(即多可用区，本字段填写实际可用区名称)，若查询结果中zoneList为空（即为单可用区，本字段填写default） |
az1 | |
| instanceUUIDList | 是 | String | 实例UUID 用,分隔，单次请求最多指定10个实例；您可以调用根据订单号查询uuid获取实例UUID | ss-eztbrc1j541lb2pim0lxr3uctdfo,ss-0bmsde9loclfnzhck4mj4g9ck9hg | |
| clientToken | 是 | String | 客户端存根，用于保证订单幂等性。要求单个云平台账户内唯一，使用同一个ClientToken值，其他请求参数相同时，则代表为同一个请求。保留时间为24小时 | ea1b9004-f450-11ec-8d4f-00155de3fd73 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败)，默认值:800 | 800 | |
| errorCode | String | 业务细分码，为product.module.code三段式码，详见错误码说明 | Ebm.Delete.NotValid | |
| error | String | 业务细分码，为product.module.code三段式码，详见错误码说明 | Ebm.Delete.NotValid | |
| message | String | 响应结果的描述，一般为英文描述 | error request | |
| description | String | 响应结果的描述，一般为中文描述 | 错误请求 | |
| returnObj | Object | 返回参数，参考表returnObj | {} | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| regionID | String | 资源池ID | 100054c0416811e9a6690242ac110002 | |
| masterOrderID | String | 订单ID | 86f7f49e241a11edb4f83003c86a1328,73b4726b872a4316bb638445997d656d | |
| masterOrderNO | String | 订单号 | 20241018134233050535,20241018134233050634 |
请求示例
请求头header
无
请求体body
示例：批量删除指定物理机
{
"regionID": "100054c0416811e9a6690242ac110002",
"azName": "az2",
"instanceUUIDList": "ss-eztbrc1j541lb2pim0lxr3uctdfo,ss-0bmsde9loclfnzhck4mj4g9ck9hg",
"clientToken": "ea1b9004-f450-11ec-8d4f-00155de3fd73"
}
响应示例
{
"statusCode": 800,
"errorCode": "",
"message": "SUCCESS",
"description": "成功",
"returnObj": {
"regionID": "100054c0416811e9a6690242ac110002",
"masterOrderID": "86f7f49e241a11edb4f83003c86a1328,73b4726b872a4316bb638445997d656d",
"masterOrderNO": "20241018134233050535,20241018134233050634"
}
}
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 表示请求成功 |
错误码
| 错误码 | 描述 |
|---|---|
| Ebm.BatchDelete.NotValid | 请求参数非法 |
| Ebm.Common.CheckError | 内部错误，请重试 |
| 其他 | 参见公共错误码说明 |
