创建虚拟机迁移任务

POST

/migrateVm

最后修改时间：2026-07-05 11:46:28

Creates an offline migration task. The VM must be shut down during migration. Source host runs vzdump, target host downloads backup with resume support and runs qmrestore. Source VM is deleted with purge only after target restore succeeds. Failed migration does not delete the source VM.

请求参数

Body 参数application/json必填

示例

Migrate VM to target nodeUse source VMID on target

{
    "hostId": 1007,
    "targetNodeId": 9,
    "targetVmid": 149,
    "targetStorage": "hddhome",
    "backupDir": "/home/software/QAgent/migration/backups",
    "startAfterMigration": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Migrate VM to target nodeUse source VMID on target

curl --location '/migrateVm' \
--header 'Content-Type: application/json' \
--data '{
    "hostId": 1007,
    "targetNodeId": 9,
    "targetVmid": 149,
    "targetStorage": "hddhome",
    "backupDir": "/home/software/QAgent/migration/backups",
    "startAfterMigration": false
}'

返回响应

🟢200

application/json

Task created

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 123,
        "nodeid": 1,
        "vmid": 100,
        "hostid": 1001,
        "type": 40,
        "status": 0,
        "params": {
            "sourceNodeId": 1,
            "targetNodeId": 2,
            "sourceVmid": 100,
            "targetVmid": 2001,
            "targetStorage": "local-lvm",
            "backupDir": "/home/software/QAgent/migration/backups",
            "progress": 0,
            "stage": "QUEUED",
            "startAfterMigration": false
        },
        "error": null,
        "createDate": 1783227600000
    }
}

后台-查询脚本执行记录

获取虚拟机迁移进度