文档目录

如何修改云主机删除策略

ZStack Cloud支持通过系统登录或第三方API工具(例如Postman)使用HTTP方式调用API修改云主机删除策略。本文主要以管理员身份(admin)登录管理节点系统,介绍如何修改云主机删除策略。

API调用流程

API详细调用流程如下:
  1. 进入管理节点系统,发送以下Curl请求登录云平台:
    curl -H "Content-Type: application/json;charset=UTF-8" \
    -X PUT -d '{"logInByAccount":{"accountName":"admin","password":"b109f3bbbc244eb82441917ed06d618b9008dd09b3befd1b5e07394c706a8bb980b1d7785e5976ec049b46df5f1326af5a2ea6d103fd07c95385ffab0cacbc86" }}' \
    http://localhost:8080/zstack/v1/accounts/login
    其中:
    • password字段需填入经过SHA-512算法加密的密码
    返回结果为:
    {"inventory":{"uuid":"cbc32f54862f4a5296b97a1302975fb9","accountUuid":"a07965e9d6f34924824fc5e9a6518fc3","userUuid":"a07965e9d6f34924824fc5e9a6518fc3","expiredDate":"Oct 17, 2022 10:43:53 PM","createDate":"Oct 17, 2022 8:43:53 PM","noSessionEvaluation":false}}
    其中:
    • uuid字段即为获取的本次Session的ID,表示登录成功
  2. 修改云主机删除策略:
    curl -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: OAuth cbc32f54862f4a5296b97a1302975fb9" \
    -X PUT -d '{"updateGlobalConfig":{"name":"deletionPolicy","category":"vm","value":"Direct"}}' \
    http://localhost:8080/zstack/v1/global-configurations/vm/deletionPolicy/actions
    其中:value字段为云主机删除策略的执行模式,本次修改为Direct。可选值:
    • Direct:从数据库彻底删除云主机并删除对应根云盘
    • Delay:从数据库变更云主机状态为已删除,到达预设置延迟时间节点,彻底删除云主机并删除对应根云盘
    • Never:从数据库彻底删除云主机并保留对应根云盘
    返回结果为:
    {"apiTimeout":1800000,"location":"http://172.20.14.227:8080/zstack/v1/api-jobs/e88336d52b9a4ea7aef950e29d2cb24f"}
    其中:
    • location字段为请求修改目标云主机删除策略API操作返回的轮询地址
  3. 轮询API结果:
    curl -H "Content-Type: application/json;charset=UTF-8" \
    -X GET http://172.20.14.227:8080/zstack/v1/api-jobs/e88336d52b9a4ea7aef950e29d2cb24f
    返回结果为:
    {"inventory":{"id":68,"name":"deletionPolicy","category":"vm","description":"the behavior of deleting a vm, options are [Direct, Delay, Never]. Direct: delete the vm from database and directly delete its root volume; Delay: change the vm\u0027s state to Destroyed in database; after the period controlled by \u0027expungePeriod\u0027 passes, delete the vm from database and delete it\u0027s root volume; Never: delete the vm from database but never delete its root volume","defaultValue":"Delay","value":"Direct"}}
    其中:
    • value字段即为所修改目标云主机删除策略,当前生效值:Direct

至此,完成云主机删除策略修改设置。

开发手册 | 4.8.38 | ZStack Cloud · ZCF | ZStack 资源中心