计算管理/虚拟机相关接口
POSTVM Related Interfaces起始版本 4.1.0同步需要认证
从快照组新建虚拟机
从快照组新建虚拟机
调试可用性
在线调试
使用当前认证信息和示例参数提交 Mock 请求。
路径参数
请求参数
路径参数
volumeSnapshotGroupUuidString必填快照组UUID
请求体字段
nameString必填资源名称。
descriptionString资源的详细描述。
instanceOfferingUuidString实例offering UUID。
cpuNumIntegerCPU数量。
memorySizeLong内存大小。
响应状态
请求地址
POST/zstack/v1/vm-instances/from/volume-snapshots/group/{volumeSnapshotGroupUuid}
/zstack/v1/vm-instances/from/volume-snapshots/group/{volumeSnapshotGroupUuid}
请求示例
curl -X POST 'http://{host}/zstack/v1/vm-instances/from/volume-snapshots/group/{volumeSnapshotGroupUuid}' -H 'Authorization: OAuth {sessionUuid}' -H 'Content-Type: application/json;charset=UTF-8' -d '{"name":"<name>","description":"<description>","instanceOfferingUuid":"<instanceOfferingUuid>","cpuNum":1,"memorySize":1,"l3NetworkUuids":["<l3NetworkUuids>"],"type":"<type>","zoneUuid":"<zoneUuid>","clusterUuid":"<clusterUuid>","hostUuid":"<hostUuid>","primaryStorageUuidForRootVolume":"<primaryStorageUuidForRootVolume>","defaultL3NetworkUuid":"<defaultL3NetworkUuid>","strategy":"<strategy>","resourceUuid":"<resourceUuid>","tagUuids":["<tagUuids>"],"systemTags":["<systemTags>"],"userTags":["<userTags>"],"rootVolumeSystemTags":["<rootVolumeSystemTags>"],"dataVolumeSystemTags":{},"reservedMemorySize":1,"vmNicParams":"<vmNicParams>","resetTpm":true}'
响应示例
200{ "inventory": { "uuid": "109d10001c5c3553a7f2333e6a48610a", "name": "Test-VM", "description": "web server VM", "zoneUuid": "f31cb809cf0b3c668953e2507d5467b2", "clusterUuid": "fdfdf92e7bbe3212ab6530b11d8e0af5", "imageUuid": "96acc892dd793fb98c1924d54eb27a88", "hostUuid": "8eb85f51f10c30c0a6305b73d2002899", "lastHostUuid": "59ae08c1f6ed3638b6e4aa35b5a30d2e", "instanceOfferingUuid": "8b6d6aabad773972a0549539099e3e68", "rootVolumeUuid": "70eda0fe06163e67accf01a266fd5274", "platform": "Linux", "defaultL3NetworkUuid": "5ec42284ceaa3ad18f2b498e98ab6acc", "type": "UserVm", "hypervisorType": "KVM", "memorySize": 8589934592, "cpuNum": 1, "allocatorStrategy": "LastHostPreferredAllocatorStrategy", "createDate": "Nov 14, 2017 10:20:57 PM", "lastOpDate": "Nov 14, 2017 10:20:57 PM", "state": "Running", "vmNics": [ { "uuid": "b6d840187f1932209c21888923f5f35e", "vmInstanceUuid": "109d10001c5c3553a7f2333e6a48610a", "usedIpUuid": "54e8db987a4a333c80a87e4a84ab7675", "l3NetworkUuid": "5ec42284ceaa3ad18f2b498e98ab6acc", "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 10:20:57 PM", "lastOpDate": "Nov 14, 2017 10:20:57 PM" } ], "allVolumes": [ { "uuid": "70eda0fe06163e67accf01a266fd5274", "name": "Root-Volume-For-VM-109d10001c5c3553a7f2333e6a48610a", "primaryStorageUuid": "0739abbe904639649da74cdcf0abd25f", "vmInstanceUuid": "109d10001c5c3553a7f2333e6a48610a", "rootImageUuid": "96acc892dd793fb98c1924d54eb27a88", "installPath": "/zstack_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-70eda0fe06163e67accf01a266fd5274/70eda0fe06163e67accf01a266fd5274.qcow2", "type": "Root", "format": "qcow2", "size": 107374182400, "actualSize": 21474836480, "deviceId": 0, "state": "Enabled", "status": "Ready", "createDate": "Nov 14, 2017 10:20:57 PM", "lastOpDate": "Nov 14, 2017 10:20:57 PM" } ] } }变更历史
此 API 暂无变更历史记录。