关机

POST/v2/instances/{instance_id}/stop

关机实例，可选强制断电。

Bearer Token instances:write api.demo.acme-cloud.dev

请求参数

共 1 项

instance_id 必填路径

string

instance_id 唯一标识

请求体

application/json

force 可选

boolean · 默认 false

为 true 时直接断电，等同拔电源

timeout_seconds 可选

integer · 默认 60

优雅关机的等待秒数，超时后强制断电

响应

2 种状态

202 Accepted

响应示例

{
  "instance_id": "ins_4f21b8",
  "status": "stopping",
  "task_id": "task_77c1e2"
}

代码示例

cURL

curl -i -X POST 'https://api.demo.acme-cloud.dev/v2/instances/instance_id_7f3a21/stop' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "force": false,
  "timeout_seconds": 60
}'