批量退订或销毁云主机

POST

/v4/ecs/batch-delete

批量退订或者销毁云主机，默认直接销毁，要求：
1.云主机必须存在
2.批量释放资源一次不能超过10个
3.释放云主机前请先检查云主机是否绑定虚拟IP，如果有请先解绑虚拟IP
4.请检查云主机是否存在快照，如果存在快照不允许释放云主机
5.云主机处于关机状态下才可释放

未对齐：

混合云v2订单侧批量退订接口不支持包周期和按需同时退订，所以只能退订时只能单个去循环退订，返回最后一个资源的订单id

请求参数

Header 参数

Body 参数application/json

示例

{
    "clientToken": "batch-delete-111234567891",
    "instanceIDList": [
        "5d13f95f-894d-69f0-7b2c-7bdcb65ad1a0",
        "a481e68d-3f19-4056-5792-e3b2176051db"
    ],
   "regionID": "2022guizhou_syj",
   "unsubscribeOnly":true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://ct-global.ctapi-internal.ctyun.local:31111/v4/ecs/batch-delete' \
--header 'userID: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'userID: {{userID}}' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientToken": "batch-delete-111234567891",
    "instanceIDList": [
        "5d13f95f-894d-69f0-7b2c-7bdcb65ad1a0",
        "a481e68d-3f19-4056-5792-e3b2176051db"
    ],
   "regionID": "2022guizhou_syj",
   "unsubscribeOnly":true
}'

返回响应

🟢200successful operation

application/json

Body

示例

成功示例成功示例

{
    "description": "成功",
    "errorCode": "Success",
    "message": "success",
    "returnObj": {
        "regionID": "2022guizhou_syj",
        "masterOrderID": "20260108000138",
        "masterOrderNO": "20260108000138",
        "resources": [
            {
                "resourceID": "7460e174-931b-4b11-bfa5-6da8217f53e8"
            },
            {
                "resourceID": "6d1a6f85-1197-4392-b136-8761d982316c"
            }
        ]
    },
    "statusCode": 800,
    "traceID": "904be028a5845d8b883974158d513d68"
}

修改于 2026-01-08 11:49:27

退订或销毁云主机

克隆云主机