注意:如果虚拟机电源处于打开状态,必须先关闭电源才能操作。

请求地址:

请求地址请求方法
/api/disk/customexpPOST

请求参数

参数类型是否必填最大长度描述示例值
filenameString500磁盘文件名/vmfs/volumes/5e5b23b2-a4e7fb00-8d08-c4834f165c2c/2.vmdk
unitStringN

容量大小单元,单位以"m"(MB)  "g"(GB)

示例:预设200MB,对应为200m

注意:预设的大小,不能小于原磁盘容量大小

200m
modeint1响应模式:0同步、1异步,默认为1,各差异如下:

同步:服务器不会立即响应客户端,一直等待超时或者任务已被执行(不管成功与失败)

异步:服务器会立即响应客户端,通过任务ID获得任务执行结果

clientidString32代理客户端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":"内部错误"}