如何创建加载数据云盘的云主机

如何创建加载数据云盘的云主机

ZStack Cloud支持通过系统登录或第三方API工具（例如Postman）使用HTTP方式调用API创建云主机。本文主要以管理员身份（admin）登录管理节点系统，介绍如何创建一个加载数据云盘的云主机。您也可以使用云平台其他已授权账户/用户身份登录系统创建。

调用API创建云主机前，需确保：

云主机所需的物理机、主存储、镜像、计算规格、二层网络、三层网络等资源均已准备就绪。详细可参考如何初始化云平台。

API调用流程概览：

登录云平台
创建云盘规格
创建云主机

API调用流程

API详细调用流程如下：

进入管理节点系统，发送以下Curl请求登录云平台以获取Session ID：

curl -H "Content-Type: application/json;charset=UTF-8" \ -X PUT -d '{"logInByAccount":{"accountName":"admin","password":"b109f3bbbc244eb82441917ed06d618b9008dd09b3befd1b5e07394c706a8bb980b1d7785e5976ec049b46df5f1326af5a2ea6d103fd07c95385ffab0cacbc86" }}' \ http://localhost:8080/zstack/v1/accounts/login

其中：

password字段需填入经过SHA-512算法加密的密码

返回结果为：

{"inventory":{"uuid":"155dbbe8193344a5913c412f2732c0d7","accountUuid":"36c27e8ff05c4780bf6d2fa65700f22e","userUuid":"36c27e8ff05c4780bf6d2fa65700f22e","expiredDate":"Apr 19, 2022 8:06:42 PM","createDate":"Apr 19, 2022 6:06:42 PM","noSessionEvaluation":false}}

其中：

uuid字段即为获取的本次Session的ID

创建云盘规格：

curl -H "Content-Type: application/json" -H "Authorization: OAuth 155dbbe8193344a5913c412f2732c0d7" \ -X POST -d '{"params":{"name":"diskOffering1","diskSize":21474836480}}'  \ http://localhost:8080/zstack/v1/disk-offerings

其中：

Authorization字段需填入登录云平台时获取的Session ID
HTTP请求URL为：http://localhost:8080/zstack/v1/disk-offerings
name：必填项，设置云盘规格名称
diskSize：必填项，设置用该云盘规格所创云盘的大小，单位为Byte

返回结果：

{"inventory":{"uuid":"f02c541041d3481d84abc9f748a11937","name":"diskOffering1","diskSize":21474836480,"sortKey":0,"state":"Enabled","type":"DefaultDiskOfferingType","createDate":"Jul 22, 2022 12:21:02 PM","lastOpDate":"Jul 22, 2022 12:21:02 PM","allocatorStrategy":"DefaultPrimaryStorageAllocationStrategy"},"type":{"_name":"key.event.API.API_EVENT"},"apiId":"e9552019273d4a728b2cf7bf09ad66a3","success":true,"id":"5ba073ca4aa74edda479a6ca3c7cc623","createdTime":1658463662414}

其中：

uuid字段即为所创建成功的云盘规格的UUID

创建云主机：

curl -H "Content-Type: application/json" -H "Authorization: OAuth 155dbbe8193344a5913c412f2732c0d7" \ -X POST -d'{"params":{"name":"VM1","instanceOfferingUuid":"35ae1685021c44888f81d9afee704300","imageUuid":"52a6b220d94c4b369b3520c76c90036a","l3NetworkUuids":["1abe265517d54df3b237c9bbb3023d3a"],"dataDiskOfferingUuids":["f02c541041d3481d84abc9f748a11937"],"clusterUuid":"a9779ce0a5ee48c484b248b7ef4e42c8","description":"This is a test VM instance","strategy":"InstantStart"}}'  \ http://localhost:8080/zstack/v1/vm-instances

其中：

Authorization字段需填入登录云平台时获取的Session ID
HTTP请求URL为：http://localhost:8080/zstack/v1/vm-instances
name：必填项，设置云主机名称
instanceOfferingUuid：必填项，指定用于创建云主机的计算规格的UUID
imageUuid：必填项，指定用于创建云主机的镜像的UUID
dataDiskOfferingUuids：选填项，指定用于创建数据云盘所使用的云盘规格UUID，云盘创建成功后，会自动加载至云主机
l3NetworkUuids：必填项，指定云主机所在三层网络的UUID，支持指定一个或多个三层网络
clusterUuid：选填项，用于指定云主机所在物理机集群
strategy：选填项，用于设置云主机创建完成后是否立即启动

返回结果：

{"inventory":{"uuid":"6ee5990c5c4f4fdabb755148b1dbaaa2","name":"VM1","description":"This is a test VM instance","zoneUuid":"7e63ce956d5b41598a53cf79b59ce967","clusterUuid":"a9779ce0a5ee48c484b248b7ef4e42c8","imageUuid":"52a6b220d94c4b369b3520c76c90036a","hostUuid":"3f4530be5fdb4e54a6976a45d47ed53c","lastHostUuid":"3f4530be5fdb4e54a6976a45d47ed53c","instanceOfferingUuid":"35ae1685021c44888f81d9afee704300","rootVolumeUuid":"cb04ce84aa7847c0bed050d1eb542c1c","platform":"Linux","architecture":"x86_64","defaultL3NetworkUuid":"1abe265517d54df3b237c9bbb3023d3a","type":"UserVm","hypervisorType":"KVM","memorySize":1073741824,"cpuNum":1,"cpuSpeed":0,"allocatorStrategy":"LeastVmPreferredHostAllocatorStrategy","createDate":"Jul 22, 2022 1:15:27 PM","lastOpDate":"Jul 22, 2022 1:15:32 PM","state":"Running","internalId":5,"vmNics":[{"uuid":"91362c6735194c9e9a6edbb1a1bb95d8","vmInstanceUuid":"6ee5990c5c4f4fdabb755148b1dbaaa2","usedIpUuid":"ff06befe00f13152aa2893134d961848","l3NetworkUuid":"1abe265517d54df3b237c9bbb3023d3a","ip":"192.168.101.45","mac":"fa:14:a3:64:ce:00","hypervisorType":"KVM","netmask":"255.255.255.0","gateway":"192.168.101.1","driverType":"virtio","usedIps":[{"uuid":"ff06befe00f13152aa2893134d961848","ipRangeUuid":"3e387e4419914167b1e70b774785f632","l3NetworkUuid":"1abe265517d54df3b237c9bbb3023d3a","ipVersion":4,"ip":"192.168.101.45","netmask":"255.255.255.0","gateway":"192.168.101.1","ipInLong":3232261421,"vmNicUuid":"91362c6735194c9e9a6edbb1a1bb95d8","createDate":"Jul 22, 2022 1:15:28 PM","lastOpDate":"Jul 22, 2022 1:15:28 PM"}],"internalName":"vnic5.0","deviceId":0,"type":"VNIC","createDate":"Jul 22, 2022 1:15:28 PM","lastOpDate":"Jul 22, 2022 1:15:28 PM"}],"allVolumes":[{"uuid":"6b82dfbd37ad4869b4c07287b7bae0ac","name":"DATA-for-VM1","description":"DataVolume-6ee5990c5c4f4fdabb755148b1dbaaa2","primaryStorageUuid":"30e757fdce01424689fc3a85dc86b60f","vmInstanceUuid":"6ee5990c5c4f4fdabb755148b1dbaaa2","diskOfferingUuid":"f02c541041d3481d84abc9f748a11937","installPath":"/cloud_ps/dataVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-6b82dfbd37ad4869b4c07287b7bae0ac/6b82dfbd37ad4869b4c07287b7bae0ac.qcow2","type":"Data","format":"qcow2","size":8589934592,"actualSize":0,"deviceId":1,"state":"Enabled","status":"Ready","createDate":"Jul 22, 2022 1:15:28 PM","lastOpDate":"Jul 22, 2022 1:15:30 PM","isShareable":false},{"uuid":"cb04ce84aa7847c0bed050d1eb542c1c","name":"ROOT-for-VM1","description":"Root volume for VM[uuid:6ee5990c5c4f4fdabb755148b1dbaaa2]","primaryStorageUuid":"30e757fdce01424689fc3a85dc86b60f","vmInstanceUuid":"6ee5990c5c4f4fdabb755148b1dbaaa2","rootImageUuid":"52a6b220d94c4b369b3520c76c90036a","installPath":"/cloud_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-cb04ce84aa7847c0bed050d1eb542c1c/cb04ce84aa7847c0bed050d1eb542c1c.qcow2","type":"Root","format":"qcow2","size":19862528,"actualSize":16384000,"deviceId":0,"state":"Enabled","status":"Ready","createDate":"Jul 22, 2022 1:15:28 PM","lastOpDate":"Jul 22, 2022 1:15:30 PM","isShareable":false}],"vmCdRoms":[{"uuid":"f1f86360448240ce8d223dbc1ab37df0","vmInstanceUuid":"6ee5990c5c4f4fdabb755148b1dbaaa2","deviceId":0,"name":"vm-6ee5990c5c4f4fdabb755148b1dbaaa2-cdRom","createDate":"Jul 22, 2022 1:15:28 PM","lastOpDate":"Jul 22, 2022 1:15:28 PM"}],"guestOsType":"Linux"},"type":{"_name":"key.event.API.API_EVENT"},"apiId":"c710bb3e24844f488f85196d9ba1e0b2","success":true,"id":"43e8676207d34302a914b16123e38e88","createdTime":1658466927855}

其中：

uuid字段即为所创建成功的云主机的UUID

升级提醒

若您选择升级至4.0.0及之后版本，请注意以下功能调整：

1. 云路由器全面升级为VPC路由器，云路由网络全面升级为VPC网络，不再单独设云路由器页面。升级全程无感知，相关业务不受任何影响。

2. 企业管理账号体系取代用户组与用户，不再单独设用户/用户组页面，不可再使用用户/用户组账号登录云平台。升级前，请先将“用户组与用户”纳管的账号数据妥善迁移至“企业管理”纳管，再执行升级操作。注意：对于admin创建并具备admin权限的用户账号同步取消，如有需要，可使用企业管理账号体系中的平台管理员实现相同功能。

3. 调整AD/LDAP与账户的对接管理方式，统一由企业管理纳管，不再单独设AD/LDAP页面。升级前，请先将“账户”对接纳管的AD/LDAP账号数据妥善迁移至“企业管理”纳管，再执行升级操作。

如对上述升级提醒有任何疑问或需要升级帮助，请联系ZStack官方技术支持

下载提醒

1.灵活的备份计划设置：轻松设定备份计划，自定义备份策略和保留策略，增量备份和全量备份可以设置不同的保留策略，在保证数据安全的同时最大限度地优化存储空间。

2.第三方认证服务器支持添加AD和LDAP，支持同步AD/LDAP用户成为虚拟化平台子账户，并使用指定的登录属性直接登录虚拟化平台。

3.分布式交换机不同主机上的上行链路网卡可以同时支持单网卡和聚合网卡，可以灵活配置网络，满足服务器虚拟化用户的网络配置需求。

如对上述升级提醒有任何疑问或需要下载帮助，请联系ZStack官方技术支持

API调用流程

客户评论

撰写评论

产品

解决方案

支持

联系