如何修改云主机删除策略
ZStack Cloud支持通过系统登录或第三方API工具(例如Postman)使用HTTP方式调用API修改云主机删除策略。本文主要以管理员身份(admin)登录管理节点系统,介绍如何修改云主机删除策略。
API调用流程
API详细调用流程如下:
- 进入管理节点系统,发送以下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,表示登录成功
- 修改云主机删除策略:
其中:value字段为云主机删除策略的执行模式,本次修改为Direct。可选值: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- Direct:从数据库彻底删除云主机并删除对应根云盘
- Delay:从数据库变更云主机状态为已删除,到达预设置延迟时间节点,彻底删除云主机并删除对应根云盘
- Never:从数据库彻底删除云主机并保留对应根云盘
返回结果为:
其中:{"apiTimeout":1800000,"location":"http://172.20.14.227:8080/zstack/v1/api-jobs/e88336d52b9a4ea7aef950e29d2cb24f"}- location字段为请求修改目标云主机删除策略API操作返回的轮询地址
- 轮询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
至此,完成云主机删除策略修改设置。
