创建云主机(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, 请参见 创建(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 | |
zoneUuid | 如果非null, 云主机将在所指定的区域上创建; clusterUuid和hostUuid优先于这个参数的设置 | 是 | 0.6 | |
clusterUuid | 如果非null, 云主机将在所指定的集群上创建; hostUuid优先于这参数的设置 | 是 | 0.6 | |
hostUuid | 如果非null, 云主机将在所指定的物理主机上创建 | 是 | 0.6 | |
defaultL3NetworkUuid | 如果l3NetworkUuids包含了多余一个的L3网络的UUID, 这个参数指定哪个L3网络是默认的L3网络。如果l3NetworkUuids只有一个L3网络UUID,可不设置这个参数。 | 是 | 0.6 | |
primaryStorageUuidForRootVolume | 主存储UUID。若指定,云主机的根云盘会在指定主存储创建。 | 是 | 1.8 | |
strategy | 云主机创建策略,创建后立刻启动或创建后不启动。 | 是 | 0.6 | |
userTags | 用户标签,请参见 创建用户标签(CreateUserTag);资源类型是 VmInstanceVO | 是 | 0.6 | |
systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag); 资源类型是 VmInstanceVO | 是 | 0.6 | |
timeout | 是 |
Note:
- ZStack创建云主机时支持亲和组功能,SystemTags增加affinityGroup选项。
- 选项格式为:
affinityGroupUuid::UUID
- 例如:
affinityGroupUuid::5fd71606d5af451d981413f35367a8d6
- 选项格式为:
- ZStack创建云主机时支持指定PCI设备,SystemTags增加PCI设备选项。
- 选项格式为:
pciDevice::UUID
- 例如:
pciDevice::634b48a7bca139d9944a0f95b0c2dddf
- 选项格式为:
- ZStack创建云主机时支持CPU绑定功能,SystemTags增加vmCpuPinning选项。
- 选项格式为:
vmCpuPinning::绑定策略
- 例如:
vmCpuPinning::1:3;1-3:4-7,^6
- 仅admin支持更新、创建、删除该SystemTag。克隆云主机时,同时会克隆此SystemTag
- 选项格式为:
- ZStack创建云主机时支持userdata功能,SystemTags增加userdata选项。
- 选项格式为:
userdata::脚本的base64编码
- 例如:
userdata::I2Nsb3VkLWNvbmZpZwp1c2VyczoKIC0gbmFtZTogdGVzdAogICBzaGVsbDogL2Jpbi9iYXNoCiAgIGdyb3VwczogdXNlcnMKICAgc3VkbzogWydBTEw9KEFMTCkgTk9QQVNTV0Q6QUxMJ10KICAgc3NoLWF1dGhvcml6ZWQta2V5czoKICAgICAgIC0gc3NoLXJzYSBBQUFBQjNOemFDMUxYQ0pmanJvRDFsVCByb290QDEwLTAtMC0xOApib290Y21kOgogLSBta2RpciAvdG1wL3RlbXAgCndyaXRlX2ZpbGVzOgogLSBwYXRoOiAvdG1wL1pTdGFja19jb25maWcKICAgY29udGVudDogfAogICAgICAgSGVsbG8sd29ybGQhCiAgIHBlcm1pc3Npb25zOiAnMDc1NScKaG9zdG5hbWU6IFBlcmYtdGVzdApkaXNhYmxlX3Jvb3Q6IGZhbHNlCnNzaF9wd2F1dGg6IHllcwpjaHBhc3N3ZDoKICBsaXN0OiB8CiAgICAgIHJvb3Q6d29yZAogIGV4cGlyZTogRmFsc2UKcnVuY21kOgogLSBlY2hvIGxzIC1sIC8gPi9yb290L2xpc3Quc2g=
- 选项格式为:
- ZStack创建云主机时支持指定sshkey功能,SystemTags增加sshkey选项。
- 选项格式为:
sshkey::公钥内容
- 例如:
sshkey::ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDPAGDmLG2yW1fGQsek4PdBL6wiVMHuLrl566ITPAf8A2Oi5BaExoUwdPjA96OaUSrtlsKlrXUMGEJwN1r1TrL9JdUMg7jww3QysGuS3P+bRsBe1TSGHS8LNc9JY9HpoL4ZN/j0zTaZfju9eDzbVsbDrF91x3yDeeGH6IG6gWJn96HPfrlg7REfo04eBdflsTaaFC0lAXoBOrnGVnzRdQfwTNRGmMAyFzCV83HOhVzBJuL5VqtAT8a0lSC4QgZTNROh6zbkTUUYYQu0QS65EaJCTyAhksuidRzyjLX3p3oMileKdJNugRa5IDHhGJXExIK+58Nvaqfj/03yN8IfO7sj root@hpe-77
- 选项格式为:
- ZStack创建云主机时支持指定云主机高可用功能,SystemTags增加ha选项。
- 选项格式为:
ha::NeverStop
- 例如:
ha::NeverStop
- 选项格式为:
- ZStack创建云主机时支持指定云主机控制台模式,SystemTags增加vmConsoleMode选项。
- 选项格式为:
vmConsoleMode::控制台模式
- 例如:
vmConsoleMode::spice或者vmConsoleMode::vnc
- 选项格式为:
- ZStack创建云主机时支持指定云主机USB重定向功能,SystemTags增加usbRedirect选项。
- 选项格式为:
usbRedirect::true
- 例如:
usbRedirect::true
- 选项格式为:
- ZStack创建云主机时支持指定云主机控制台密码,SystemTags增加consolePassword选项。
- 选项格式为:
consolePassword::控制台密码
- 例如:
consolePassword::123456
- 选项格式为:
- ZStack创建云主机时支持指定L3的IP,SystemTags增加staticIp选项。
- 选项格式为:
staticIp::三层网络UUID::指定的IP
- 例如:
staticIp::81a21a81cde84c1084c191354053a3b5::172.20.196.0
- 选项格式为:
- ZStack创建云主机时支持指定对应L3的网卡MAC地址,SystemTags增加customMac选项。
- 选项格式为:
customMac::三层网络UUID::指定的MAC地址
- 例如:
customMac::81a21a81cde84c1084c191354053a3b5::fa:00:37:ee:9f:00
- 选项格式为:
- ZStack创建云主机时支持指定云盘置备方式,SystemTags增加volumeProvisioningStrategy选项,使用
rootVolumeSystemTags参数来传递 SystemTag。
- 选项格式为:
volumeProvisioningStrategy::ThinProvisioning, volumeProvisioningStrategy::ThickProvisioning
- 例如:
volumeProvisioningStrategy::ThinProvisioning, volumeProvisioningStrategy::ThickProvisioning
- 选项格式为:
- ZStack创建云主机时支持指定根云盘所在的Ceph存储池,SystemTags增加rootPoolName选项,使用
rootPoolName参数来传递 SystemTag。
- 选项格式为:
ceph::rootPoolName::xxx, 其中xxx代表池名称
- 例如:
ceph::rootPoolName::pri-v-r-26e11ca6814d4e1ba504d845f7848db3
- 选项格式为: