退订或销毁云主机

POST

/v4/ecs/unsubscribe

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

请求参数

Header 参数

Body 参数application/json

示例

{
    "clientToken": "112344567891234",
    "ID": "d1b022f9-ac0b-3dde-4efd-d85168eb00e1",
    "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/unsubscribe' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userID: {{userID}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientToken": "112344567891234",
    "ID": "d1b022f9-ac0b-3dde-4efd-d85168eb00e1",
    "regionID": "2022guizhou_syj",
    "unsubscribeOnly": true
}'

返回响应

🟢200successful operation

application/json

Body

示例

{
    "description": "成功",
    "errorCode": "Success",
    "message": "success",
    "returnObj": {
        "masterOrderID": "20260108000125",
        "masterOrderNO": "20260108000125",
        "masterResourceID": "d1b022f9-ac0b-3dde-4efd-d85168eb00e1",
        "regionID": "2022guizhou_syj",
        "Resources": [
            {
                "resourceID": "d1b022f9-ac0b-3dde-4efd-d85168eb00e1"
            }
        ]
    },
    "statusCode": 800,
    "traceID": "d061be6279f39095f3bd67e23d9a6bb8"
}

修改于 2026-01-08 12:19:38

批量创建按量付费或者包年包月云主机

批量退订或销毁云主机