注意:如果虚拟机电源处于打开状态,必须先关闭电源才能操作。
请求地址:
请求地址 | 请求方法 |
/api/disk/customexp | POST |
请求参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
filename | String | 是 | 500 | 磁盘文件名 | /vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/2.vmdk |
unit | String | 是 | N | 容量大小单元,单位以"m"(MB) "g"(GB) 示例:预设200MB,对应为200m 注意:预设的大小,不能小于原磁盘容量大小 | 200m |
mode | int | 否 | 1 | 响应模式:0同步、1异步,默认为1,各差异如下: 同步:服务器不会立即响应客户端,一直等待超时或者任务已被执行(不管成功与失败) 异步:服务器会立即响应客户端,通过任务ID获得任务执行结果 | |
clientid | String | 是 | 32 | 代理客户端ID |
异步返回示例
{ "errcode": "200", "errmsg": "ok", "data": { "taskid": "be1e6a4682502fb8ad89a12444c40998" } }
异步返回参数说明
参数 | 描述 |
taskid | 任务ID,可用于获取任务执行信息 |
同步返回示例
{ "TaskID": "98784684b0722d27b268016a9112dfd2", "Describe": "自定义磁盘文件扩容", "Content": { "file": { "exp_size": "130M", "filename": "/vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/vmdk/3.vmdk", "size": "130" }, "task": { "event_name": "EVENT_DISKFILE_GROW", "progress_bar": "100%", "task_errcode": "200", "task_errmsg": "success" } }, "InsertTime": 1695548458, "UpdateTime": 1695548458, "ExpireTime": 1695634858 }
同步返回参数说明
参数 | 描述 |
TaskID | 任务ID |
Describe | 任务描述 |
Clientid | 代理客户端ID |
Content | 任务详情 |
task | 任务执行信息 |
event_name | 事件名称 |
task_errcode | 错误代码 |
task_errmsg | 错误提示 |
progress_bar | 配置进度 |
file | 文件信息 |
filename | 磁盘文件名 |
size | 磁盘总容量大小,单位MB |
exp_size | 扩容大小,m代表(MB),g代表(GB) |
InsertTime | 任务创建时间 |
UpdateTime | 任务更新时间 |
ExpireTime | 任务有效时间 |
异常示例
{"errcode":"500","errmsg":"内部错误"}