v0.1.7

生命週期端點

最後更新


本頁說明開機、重開、關機、強制停止與刪除 VM 的五個端點。

一覽


端點qm 指令VM 狀態要求回應
POST /api/vm/:id/startqm start停止中SSE,等到 SSH 可登入
POST /api/vm/:id/rebootqm reboot執行中SSE,等到 SSH 可登入
POST /api/vm/:id/shutdownqm shutdown執行中文字 ok
POST /api/vm/:id/stopqm stop執行中文字 ok
POST /api/vm/:id/destroyqm destroy停止中文字 ok

全部受 ALLOW_IPS 與停用清單限制,指令依 多節點調度 在 VM 所在節點執行。

start/reboot


  1. curl -N -X POST http://192.168.0.11:8080/api/vm/120/start

  1. data: {"step":"starting VM","status":"success","message":"[+] VM starting (1.12s)"}
  2. data: {"step":"waiting for SSH","status":"success","message":"[+] VM is ready (24.37s)"}
  3. data: {"step":"finalizing","status":"info","message":"[+] VM started successfully"}
  4. event: close
  5. data: {}

步驟行為
執行 qm start/qm reboot失敗時送出錯誤訊息並結束
waiting for SSH依 VM 的 OS tag 決定登入使用者(debian/ubuntu/rocky),每 5 秒嘗試一次,最多 60 次
finalizing等待 5 秒後送出 info 事件

VM 沒有 OS tag(不是由本服務建立)時,waiting for SSH 以 OS user not found 失敗;開機指令本身已執行完成。

shutdown/stop


  1. curl -X POST http://192.168.0.11:8080/api/vm/120/shutdown
  2. # ok

shutdown 送出 ACPI 關機訊號並等待 qm shutdown 結束;stop 立即切斷電源。

destroy


  1. curl -X POST http://192.168.0.11:8080/api/vm/120/destroy
  2. # ok

只接受已停止的 VM,執行 qm destroy <vmid>(不帶 --purge)。刪除後該 VMID 與 IP 可再次被 自動配置 使用。

錯誤回應


情況同步端點SSE 端點
來源 IP 不在 ALLOW_IPS403單行 data: 錯誤
VM 狀態不符或在停用清單400單行 data: 錯誤
qm 失敗500 failed to ... VM: <輸出>data: 錯誤後結束
EN