迁移服务（Plus）

概述

迁移服务：提供V2V迁移服务，可将其它虚拟化平台的云主机系统及数据完整迁移至当前云平台。

目前支持以下类型的源平台迁移：

已接管的vCenter云主机迁移至当前云平台，支持迁移的源vCenter平台版本包括：5.5、6.0、6.5、6.7、7.0，且vCenter服务器（vCenter Server）和ESXi主机（ESXi Host）版本需保持一致。
基于KVM的源云平台的云主机迁移至当前云平台。

如图 1所示：

功能特点

支持对云主机进行一键式批量的V2V迁移。
用户只需添加迁移服务器并创建迁移任务，其余工作均交由云平台执行。
支持对迁移服务器设置单独的迁移网络以及网络QoS，控制传输瓶颈，提高迁移效率。
创建迁移任务过程中，支持对目标云主机进行自定义配置。
整个迁移过程可通过直观可视化的UI界面进行监控和管理。

注意事项

V2V迁移服务以单独的功能模块形式提供，需提前购买迁移服务模块许可证，且需在购买云平台许可证基础上使用，不可单独使用。

清单

V2V迁移服务器清单（V2VConversionHost inventory）

名字	描述	可选的	起始支持版本
uuid	请参见资源属性		3.0.1
name	请参见资源属性		3.0.1
description	请参见资源属性	是	3.0.1
hostUuid	物理机UUID		3.0.1
type	云盘的类型		3.0.1
state	云盘备份的启用状态		3.0.1
storagePath	V2V迁移镜像保存路径		3.0.1
groupBy	以字段分组，相当于MySQL中的group by关键字。例如groupBy=type	是	3.0.1
createDate	请参见资源属性		3.0.1
lastOpDate	请参见资源属性		3.0.1
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.0.1
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.0.1

示例

{
    "inventories": [
        {
            "createDate": "Sep 21, 2018 9:51:05 AM",
            "description": "",
            "hostUuid": "a039266264964f239196a15bec178a56",
            "lastOpDate": "Sep 21, 2018 9:51:05 AM",
            "name": "10.0.69.145",
            "state": "Enabled",
            "storagePath": "/tmp/cloud",
            "type": "VMWARE",
            "uuid": "d8281e94496947ff978e8157f04f6699"
        }
    ],
    "success": true
}

操作（Operations）

添加V2V迁移服务器(AddV2VConversionHost)

用户可以使用AddV2VConversionHost添加V2V迁移服务器。例如：

AddV2VConversionHost name=test-V2V storagePath=/tmp/cloud hostUuid=a039266264964f239196a15bec178a56 type=VMWARE

参数（Parameters）

名字	描述	可选的	可选的参数值	起始支持版本
name	资源名称			3.0.1
type	V2V迁移服务器类型		VMWARE	3.0.1
hostUuid	物理机UUID			3.0.1
description	资源的详细描述	是		3.0.1
storagePath	V2V迁移镜像保存路径			3.0.1
resourceUuid	资源UUID	是		3.0.1
tagUuids	标签UUID列表	是		3.4.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是		3.0.1
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是		3.0.1
timeout		是

Note:

ZStack Cloud添加V2V迁移服务器时支持指定V2V迁移网络CIDR，SystemTags增加networkcidr选项，使用networkcidr参数来传递 SystemTag。
- 选项格式为：conversion::network::cidr::{netcidr}
- 例如：conversion::network::cidr::{10.0.0.1/24}

修改V2V迁移服务器状态(ChangeV2VConversionHostState)

用户可以使用ChangeV2VConversionHostState修改V2V迁移服务器状态。例如：

ChangeV2VConversionHostState uuid=c4e1a78bba0646a88d6f878eb247aa6a stateEvent=disable

参数（Parameters）

名字	描述	可选的	可选的参数值	起始支持版本
uuid	资源的UUID，唯一标示该资源			3.0.1
stateEvent	状态事件	是	enable disable	3.0.1
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是		3.0.1
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是		3.0.1
timeout		是

V2V迁移(ConvertVmFromForeignHypervisor)

用户可以使用ConvertVmFromForeignHypervisor进行V2V迁移。例如：

ConvertVmFromForeignHypervisor name=test-centos7.2 url=vmware://28ff91d347d14dc9896fb4a58ea8269b cpuNum=1 memorySize=1 primaryStorageUuid=f96ec2cbac524501b313c35cd279d317 l3NetworkUuids=0d05980697ec4b96b4ab6f69ab2b74c6 conversionHostUuid=8b1791d1f3634b43a74cda9c83027b6b

参数（Parameters）

名字	描述	可选的	可选的参数值	起始支持版本
url	源云主机路径			3.0.1
name	资源名称			3.0.1
description	资源的详细描述	是		3.0.1
conversionHostUuid	V2V迁移服务器UUID	是 Note: VMWARE迁移至ZStack Cloud时为必选		3.0.1
cpuNum	CPU核数			3.0.1
memorySize	内存大小			3.0.1
zoneUuid	区域UUID	是		3.0.1
clusterUuid	集群UUID	是		3.0.1
hostUuid	物理机UUID	是		3.0.1
primaryStorageUuid	主存储UUID			3.0.1
l3NetworkUuids	三层网络UUID列表			3.0.1
defaultL3NetworkUuid	默认三层网络UUID	是		3.0.1
platform	平台	是	Linux Windows WindowsVirtio Paravirtualization Other	3.0.1
type	云主机类型	是	UserVm ApplianceVm	3.0.1
strategy	V2V迁移策略，决定迁移后目标云主机是否马上启动	是	InstantStart JustConvert	3.0.1
longJobName	迁移任务名称	是		3.0.1
longJobDescription	迁移任务描述	是		3.0.1
resourceUuid	V2V迁移长任务资源UUID	是		3.0.1
convertStrategy	迁移转化策略	是	CapacityOptimized EfficiencyFirst	3.6.0
sshPrivKey	用于验证SSH登录的私钥	是		3.6.0
pauseVm	迁移之前暂停虚拟机	是		3.6.0
volumeFilters	云盘过滤信息	是		3.6.0
tagUuids	标签UUID列表	是		3.6.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是		3.0.1
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是		3.0.1
timeout		是

删除V2V迁移服务器(DeleteV2VConversionHost)

用户可以使用DeleteV2VConversionHost删除V2V迁移服务器。例如：

DeleteV2VConversionHost uuid=c4e1a78bba0646a88d6f878eb247aa6a

参数（Parameters）

名字	描述	可选的	起始支持版本
uuid	资源的UUID，唯一标示该资源		3.0.1
deleteMode	状态事件	是	3.0.1
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.0.1
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.0.1
timeout		是

查询V2V迁移服务器(QueryV2VConversionHost)

管理员可以使用QueryV2VConversionHost查询V2V迁移服务器。例如：

QueryV2VConversionHost Uuid=8b1791d1f3634b43a74cda9c83027b6b

原生域查询（Primitive Fields of Query）

请参见 V2V迁移服务器清单（V2VConversionHost inventory）。

嵌套和扩展域查询（Nested And Expanded Fields of Query）

域（Field）	清单（Inventory）	描述	起始支持版本
host	host inventory	物理机	3.0.1

更新V2V迁移服务器(UpdateV2VConversionHost)

用户可以使用UpdateV2VConversionHost更新V2V迁移服务器。例如：

 UpdateV2VConversionHost uuid=d8281e94496947ff978e8157f04f6699

参数（Parameters）

名字	描述	可选的	起始支持版本
uuid	资源的UUID，唯一标示该资源		3.0.1
name	资源名称	是	3.0.1
description	资源的详细描述	是	3.0.1
storagePath	V2V迁移镜像保存路径	是	3.0.1
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.0.1
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.0.1
timeout		是

标签（Tags）

用户可以使用resourceType=LongJobVO创建V2V迁移服务用户标签。例如：

CreateUserTag resourceType=LongJobVO tag=golden-ResourceStack
resourceUuid=3539de80967e44af99cd62ff5d53da30

用户可以使用resourceType=V2VConversionHostVO创建迁移服务器用户标签。例如：

CreateUserTag resourceType=V2VConversionHostVO tag=golden-ResourceStack
resourceUuid=8b1791d1f3634b43a74cda9c83027b6b

系统标签（System Tags）

用户可以配置V2V迁移服务器的上下行带宽。

Note: 创建SystemTag之前，使用QuerySystemTag先进行排查，确保其不存在，避免针对同一资源的同一SystemTag出现多次。

用户可以使用CreateSystemTag设置迁移服务器下行带宽，下行带宽限制从源vCenter主存储到迁移服务器的下载速度。例如：
```
CreateSystemTag resourceUuid=8b1791d1f3634b43a74cda9c83027b6b  resourceType=V2VConversionHostVO tag=networkInboundBandwidth::10000
```
用户可以使用CreateSystemTag设置迁移服务器上行带宽，上行带宽限制从迁移服务器到目标主存储的上传速度。例如：
```
CreateSystemTag resourceUuid=8b1791d1f3634b43a74cda9c83027b6b  resourceType=V2VConversionHostVO tag=networkOutboundBandwidth::10000
```

用户可以使用UpdateSystemTag更新带宽限制。例如：

UpdateSystemTag resourceUuid=8b1791d1f3634b43a74cda9c83027b6b  resourceType=V2VConversionHostVO tag=networkInboundBandwidth::20000

用户可以使用QuerySystemTag读取带宽限制。例如：

QuerySystemTag resourceUuid=8b1791d1f3634b43a74cda9c83027b6b  resourceType=V2VConversionHostVO tag=networkInboundBandwidth::10000

用户可以使用DeleteTag删除带宽限制。例如：
```
DeleteTag uuid=13500acdbac6434f8584686649ec6dc9
```