创建云主机(CreateVmInstance)
用户可以使用CreateVmInstance来创建一个云主机。
例如:
CreateVmInstance name=vm imageUuid=d720ff0c60ee48d3a2e6263dd3e12c33 \
instanceOfferingUuid=76789b62aeb542a5b4b8b8488fbaced2 \
l3NetworkUuids=37d3c4a1e2f14a1c8316a23531e62988#创建云主机指定多网卡、默认L3网络
CreateVmInstance name=test imageUuid=ee14c7c8cc46309d821c51bbae3adb70 \
instanceOfferingUuid=1cf417bfd0e94175aea92131f1000011 \
l3NetworkUuids='ac5c7e736f1b499bbd0c12763b30051d,e315b2cb6151454bbab362a6e92909e7' \
defaultL3NetworkUuid=ac5c7e736f1b499bbd0c12763b30051d#创建云主机指定多网卡、默认L3网络、指定静态IP、控制台vnc模式、设置vnc密码、高可用级别为NeverStop
CreateVmInstance name=test imageUuid=ee14c7c8cc46309d821c51bbae3adb70 \
instanceOfferingUuid=1cf417bfd0e94175aea92131f1000011 \
l3NetworkUuids='ac5c7e736f1b499bbd0c12763b30051d,e315b2cb6151454bbab362a6e92909e7' \
defaultL3NetworkUuid="ac5c7e736f1b499bbd0c12763b30051d" \
systemTags="consolePassword::123456","ha::NeverStop","vmConsoleMode::vnc","staticIp::ac5c7e736f1b499bbd0c12763b30051d::172.24.0.5"参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| name | 云主机名称,请参见 资源属性 | 0.6 | ||
| resourceUuid | 资源UUID, 若指定,云主机会使用该字段值作为UUID。请参见 创建(Create Resources) | 是 | 0.6 | |
| description | 云主机的详细描述,请参见 资源属性 | 是 | 0.6 | |
| instanceOfferingUuid | 计算规格UUID。指定云主机的CPU、内存等参数 | 是 | 0.6 | |
| imageUuid | 镜像UUID。云主机的根云盘会从该字段指定的镜像创建 | 0.6 | ||
| l3NetworkUuids | 三层网络UUID列表。可以指定一个或多个三层网络,云主机会在每个网络上创建一个网卡 | 0.6 | ||
| type | 云主机类型。保留字段,无需指定 | 是 |
|
0.6 |
| rootDiskOfferingUuid | 根云盘规格UUID。如果imageUuid字段指定的镜像类型是ISO,该字段必须指定以确定需要创建的根云盘大小。如果镜像类型是非ISO,该字段无需指定 | 是 | 0.6 | |
| dataDiskOfferingUuids | 云盘规格UUID列表。可以指定一个或多个云盘规格UUID(UUID可以重复)为云主机创建一个或多个数据云盘 | 是 | 0.6 | |
| dataDiskSizes | 自定义云盘大小列表。可以指定一个或多个云盘大小(可重复)为云主机创建一个或多个数据云盘。 | 是 | 4.4.6 | |
| zoneUuid | 区域UUID。若指定,云主机会在指定区域创建。 | 是 | 0.6 | |
| clusterUuid | 集群UUID。若指定,云主机会在指定集群创建,该字段优先级高于zoneUuid | 是 | 0.6 | |
| hostUuid | 物理机UUID。若指定,云主机会在指定物理机创建,该字段优先级高于zoneUuid和clusterUuid | 是 | 0.6 | |
| defaultL3NetworkUuid | 默认三层网络UUID。当在l3NetworkUuids指定了多个三层网络时,该字段指定提供默认路由的三层网络。若不指定,l3NetworkUuids的第一个网络被选为默认网络。 | 是 | 0.6 | |
| primaryStorageUuidForRootVolume | 主存储UUID。若指定,云主机的根云盘会在指定主存储创建。 | 是 | 1.8 | |
| strategy | 云主机创建策略,创建后立刻启动或创建后不启动。 | 是 |
|
0.6 |
| tagUuids | 标签UUID列表 | 是 | 3.4.0 | |
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 VmInstanceVO | 是 | 0.6 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 VmInstanceVO | 是 | 0.6 | |
| dataVolumeSystemTagsOnIndex | 是 | 4.4.24 | ||
| rootVolumeSystemTags | 云主机根盘所需要的系统标签 | 是 | 3.0 | |
| dataVolumeSystemTags | 云主机数据盘所需要的系统标签 | 是 | 3.0 | |
| cpuNum | 是 | 3.4.0 | ||
| memorySize | 是 | 3.4.0 | ||
| rootDiskSize | 是 | 3.4.0 | ||
| sshKeyPairUuids | 是 | 4.7.21 | ||
| reservedMemorySize | 是 | 4.7.21 |
