计算管理/虚拟机相关接口
POSTVM Related Interfaces起始版本 4.1.0同步需要认证
从快照新建虚拟机
从快照新建虚拟机
调试可用性
在线调试
使用当前认证信息和示例参数提交 Mock 请求。
路径参数
请求参数
路径参数
volumeSnapshotUuidString必填快照组UUID
请求体字段
paramsObject必填请求体参数结构
nameString必填资源名称
descriptionString资源的详细描述
instanceOfferingUuidString计算规格UUID
cpuNumIntegerCPU数量
memorySizeLong内存大小
l3NetworkUuidsList必填分布式端口组UUID
typeString虚拟机系统平台类型
vmNicParamsString网卡信息
platformString虚拟机系统平台类型
zoneUuidString数据中心UUID
clusterUuidString集群UUID
hostUuidString主机UUID
primaryStorageUuidString数据存储UUID
defaultL3NetworkUuidString默认分布式端口组UUID
strategyString创建策略
resourceUuidString资源UUID
tagUuidsList标签UUID列表
rootVolumeSystemTagsList根硬盘的系统标签
reservedMemorySizeLong已预留内存大小。
systemTagsList系统标签
userTagsList用户标签
响应状态
请求地址
POST/zstack/v1/vm-instances/from/volume-snapshots/{volumeSnapshotUuid}
/zstack/v1/vm-instances/from/volume-snapshots/{volumeSnapshotUuid}
请求示例
curl -X POST 'http://{host}/zstack/v1/vm-instances/from/volume-snapshots/{volumeSnapshotUuid}' -H 'Authorization: OAuth {sessionUuid}' -H 'Content-Type: application/json;charset=UTF-8' -d '{"params":{"name":"<name>","description":"<description>","instanceOfferingUuid":"<instanceOfferingUuid>","cpuNum":1,"memorySize":1,"l3NetworkUuids":["<l3NetworkUuids>"],"type":"<type>","vmNicParams":"<vmNicParams>","platform":"<platform>","zoneUuid":"<zoneUuid>","clusterUuid":"<clusterUuid>","hostUuid":"<hostUuid>","primaryStorageUuid":"<primaryStorageUuid>","defaultL3NetworkUuid":"<defaultL3NetworkUuid>","strategy":"<strategy>","resourceUuid":"<resourceUuid>","tagUuids":["<tagUuids>"],"rootVolumeSystemTags":["<rootVolumeSystemTags>"],"reservedMemorySize":1},"systemTags":["<systemTags>"],"userTags":["<userTags>"]}'
响应示例
200{ "inventory": { "uuid": "56331ef0c0713bc09dc2dc160fd4d48a", "name": "Test-VM", "description": "web server VM", "zoneUuid": "49783ceb7da734aab1ea137f2b7b82ac", "clusterUuid": "ebfbd2a6e08a3b78b70c9b6093f40d37", "imageUuid": "9a4914937dcd3149810793f8b040e8ad", "hostUuid": "2665407c38f932c08f3fb33bb6c8f3f4", "lastHostUuid": "2a847b5699b535d7a78b57cd411ffeac", "instanceOfferingUuid": "041ff292e60f31079dd8e6e3c9c26c72", "rootVolumeUuid": "98648a22b2c639ee88571bf1c429caba", "platform": "Linux", "defaultL3NetworkUuid": "4f80edbb396b346c9af4dcce48f94fb5", "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": "1e1b705f391c3f40a2b6ae447d0e12ca", "vmInstanceUuid": "56331ef0c0713bc09dc2dc160fd4d48a", "usedIpUuid": "bf85263c007d3959a166599181daa4b7", "l3NetworkUuid": "4f80edbb396b346c9af4dcce48f94fb5", "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": "98648a22b2c639ee88571bf1c429caba", "name": "Root-Volume-For-VM-56331ef0c0713bc09dc2dc160fd4d48a", "primaryStorageUuid": "406362409f493e14952262df535e9cf8", "vmInstanceUuid": "56331ef0c0713bc09dc2dc160fd4d48a", "rootImageUuid": "9a4914937dcd3149810793f8b040e8ad", "installPath": "/zstack_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-98648a22b2c639ee88571bf1c429caba/98648a22b2c639ee88571bf1c429caba.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 暂无变更历史记录。