跳转到主要内容
API Explorer|API Explorer
资源中心/硬件设施/主存储相关接口
PUTPrimary Storage Operations起始版本 3.1.0同步需要认证

跨主存储迁移云主机

跨主存储迁移云主机

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

路径参数

请求参数

路径参数

  • vmInstanceUuidString必填

    云主机UUID

请求体字段

  • primarystoragemigratevmObject必填

    primarystoragemigratevm 请求体结构

    • dstPrimaryStorageUuidString必填

      目标主存储UUID

    • withDataVolumesboolean

      迁移包含云盘

    • withSnapshotsboolean

      迁移包含快照

    • dstHostUuidString

      可选。

    • strategyString

      处理策略。

  • systemTagsList

    系统标签。

  • userTagsList

    用户标签。

  • migratevmObject必填

    请求体对象。

    • downTimeInteger

      下线时间。

    • bandwidthlong

      暂无描述。

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • successboolean必填

    操作是否成功。

  • errorErrorCode必填

    错误码，若不为null，则表示操作失败, 操作成功时该字段为null。 详情参考error

    • codeString必填

      错误码号，错误的全局唯一标识，例如SYS.1000, HOST.1001

    • descriptionString必填

      错误的概要描述

    • detailsString必填

      错误的详细信息

    • elaborationString必填

      保留字段，默认为null

    • opaqueLinkedHashMap必填

      保留字段，默认为null

    • causeErrorCode必填

      根错误，引发当前错误的源错误，若无原错误，该字段为null

  • inventoryVmInstanceInventory必填

    详情参考inventory

请求地址

PUT/zstack/v1/vm-instances/{vmInstanceUuid}/actions

/zstack/v1/vm-instances/{vmInstanceUuid}/actions

操作 ID

PrimaryStorageMigrateVm

永久链接

请求示例

curl -X PUT 'http://{host}/zstack/v1/vm-instances/{vmInstanceUuid}/actions' -H 'Authorization: OAuth {sessionUuid}' -H 'Content-Type: application/json;charset=UTF-8' -d '{"primarystoragemigratevm":{"dstPrimaryStorageUuid":"<dstPrimaryStorageUuid>","withDataVolumes":true,"withSnapshots":true,"dstHostUuid":"<dstHostUuid>","strategy":"<strategy>"},"systemTags":["<systemTags>"],"userTags":["<userTags>"],"migratevm":{"downTime":1,"bandwidth":1}}'

响应示例

200
{ "inventory": { "uuid": "f483af349d39312c8078d142c40fb721", "name": "Test-VM", "description": "web server VM", "zoneUuid": "b7280443258337bb9e8d2abf4a014644", "clusterUuid": "a2c0ace5be2d35b5a365067a0127b377", "imageUuid": "14fb13b692e837dfa31d75ffc02d4d4d", "hostUuid": "f0690203b1463867bcb2f5a48a1fa91a", "lastHostUuid": "655acef664af39e9b6b7fec0d4de56c0", "instanceOfferingUuid": "772a66f21ef23ba7a69ad292e4489ebb", "rootVolumeUuid": "65b10a950f1336f48b770f98b25176eb", "platform": "Linux", "defaultL3NetworkUuid": "80c8af5ff0a135e18a3e7a4d2223ebd2", "type": "UserVm", "hypervisorType": "KVM", "memorySize": 8589934592, "cpuNum": 1, "allocatorStrategy": "LastHostPreferredAllocatorStrategy", "createDate": "Nov 14, 2017 9:20:57 AM", "lastOpDate": "Nov 14, 2017 9:20:57 AM", "state": "Running", "vmNics": [ { "uuid": "b16455db309330289acb58edbfabd4b7", "vmInstanceUuid": "f483af349d39312c8078d142c40fb721", "usedIpUuid": "27787a727c143a7aada42e6c3b111887", "l3NetworkUuid": "80c8af5ff0a135e18a3e7a4d2223ebd2", "ip": "192.168.1.10", "mac": "00:0c:29:bd:99:fc", "hypervisorType": "KVM", "netmask": "255.255.255.0", "gateway": "192.168.1.1", "deviceId": 0, "state": "enable", "createDate": "Nov 14, 2017 9:20:57 AM", "lastOpDate": "Nov 14, 2017 9:20:57 AM" } ], "allVolumes": [ { "uuid": "65b10a950f1336f48b770f98b25176eb", "name": "Root-Volume-For-VM-f483af349d39312c8078d142c40fb721", "primaryStorageUuid": "55245463f914331c954909475279c3b0", "vmInstanceUuid": "f483af349d39312c8078d142c40fb721", "diskOfferingUuid": "b2cb37282f5034fb808dff68dc18db9e", "rootImageUuid": "14fb13b692e837dfa31d75ffc02d4d4d", "installPath": "/zstack_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-65b10a950f1336f48b770f98b25176eb/65b10a950f1336f48b770f98b25176eb.qcow2", "type": "Root", "format": "qcow2", "size": 107374182400, "actualSize": 21474836480, "deviceId": 0, "state": "Enabled", "status": "Ready", "createDate": "Nov 14, 2017 9:20:57 AM", "lastOpDate": "Nov 14, 2017 9:20:57 AM" }, { "uuid": "97bf368f3bde3490b0c08d37ac8bc747", "name": "Data-Volume-For-VM-f483af349d39312c8078d142c40fb721", "primaryStorageUuid": "4df2eddd6ac1307ebbff27d0044f72e9", "vmInstanceUuid": "f483af349d39312c8078d142c40fb721", "diskOfferingUuid": "06ea8f5a59843b8aa4d18d9c6d2b7a1d", "installPath": "/zstack_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-97bf368f3bde3490b0c08d37ac8bc747/97bf368f3bde3490b0c08d37ac8bc747.qcow2", "type": "Data", "format": "qcow2", "size": 536870912000, "actualSize": 107374182400, "deviceId": 1, "state": "Enabled", "status": "Ready", "createDate": "Nov 14, 2017 9:20:57 AM", "lastOpDate": "Nov 14, 2017 9:20:57 AM" } ] } }

变更历史

此 API 暂无变更历史记录。

查看全部变更历史