数据保护/备份管理相关接口
POSTBackup Management Interfaces起始版本 3.0.0同步需要认证
从虚拟机备份创建虚拟机
从虚拟机备份创建虚拟机
调试可用性
在线调试
使用当前认证信息和示例参数提交 Mock 请求。
路径参数
请求参数
路径参数
groupUuidString必填虚拟机备份组UUID
请求体字段
paramsObject必填请求体参数结构
nameString必填资源名称
backupStorageUuidString镜像存储UUID
instanceOfferingUuidString计算规格UUID
l3NetworkUuidsList一组分布式端口组的UUID
vmNicParamsString网卡信息
typeString虚拟机类型
zoneUuidString数据中心UUID
clusterUuidString集群UUID
hostUuidString主机UUID
primaryStorageUuidForRootVolumeString根硬盘数据存储UUID
primaryStorageUuidForDataVolumeString数据盘数据存储UUID
descriptionString资源的详细描述
rootVolumeSystemTagsList根硬盘系统标签
dataVolumeSystemTagsList数据盘系统标签
diskAOsList按云盘维度传递参数，DiskAO.sourceUuid 与备份对应的原始云盘UUID (VolumeBackupVO.volumeUuid) 绑定；可为每块云盘单独指定 primaryStorageUuid、systemTags 等。注意：diskAOs 与 primaryStorageUuidForRootVolume/primaryStorageUuidForDataVolume、rootVolumeSystemTags/dataVolumeSystemTags 互斥，不能同时指定
defaultL3NetworkUuidString默认分布式端口组的UUID
resourceUuidString资源UUID。若指定，资源会使用该字段值作为UUID。
tagUuidsList标签UUID列表
strategyString虚拟机创建策略
cpuNumInteger暂无描述。
memorySizeLong内存大小。
reservedMemorySizeLong已预留内存大小。
systemTagsList系统标签
userTagsList用户标签
响应状态
请求地址
POST/zstack/v1/vm-instances/from/vm-backups/{groupUuid}
/zstack/v1/vm-instances/from/vm-backups/{groupUuid}
请求示例
curl -X POST 'http://{host}/zstack/v1/vm-instances/from/vm-backups/{groupUuid}' -H 'Authorization: OAuth {sessionUuid}' -H 'Content-Type: application/json;charset=UTF-8' -d '{"params":{"name":"<name>","backupStorageUuid":"<backupStorageUuid>","instanceOfferingUuid":"<instanceOfferingUuid>","l3NetworkUuids":["<l3NetworkUuids>"],"vmNicParams":"<vmNicParams>","type":"<type>","zoneUuid":"<zoneUuid>","clusterUuid":"<clusterUuid>","hostUuid":"<hostUuid>","primaryStorageUuidForRootVolume":"<primaryStorageUuidForRootVolume>","primaryStorageUuidForDataVolume":"<primaryStorageUuidForDataVolume>","description":"<description>","rootVolumeSystemTags":["<rootVolumeSystemTags>"],"dataVolumeSystemTags":["<dataVolumeSystemTags>"],"diskAOs":["<diskAOs>"],"defaultL3NetworkUuid":"<defaultL3NetworkUuid>","resourceUuid":"<resourceUuid>","tagUuids":["<tagUuids>"],"strategy":"<strategy>","cpuNum":1,"memorySize":1,"reservedMemorySize":1},"systemTags":["<systemTags>"],"userTags":["<userTags>"]}'
响应示例
200{ "inventory": { "uuid": "a1c07d683f693f6e9f2d7f9a499c7840", "name": "Test-VM", "description": "web server VM", "zoneUuid": "1e48b41ec4b63660b38a72d271c0164b", "clusterUuid": "f29498f04b1e3c319bdaeb6b3f8259f3", "imageUuid": "5c07704333c532e8b402b6b3ddb89315", "hostUuid": "e18cf66eedb3306686a1d4685bbb63af", "lastHostUuid": "4834161c409a34b6a84e40d71d85f714", "instanceOfferingUuid": "f53ad9f147203b499dfbd93ce41b7a8e", "rootVolumeUuid": "24b9fcb69f123ad6b3ddfffed96d2882", "platform": "Linux", "defaultL3NetworkUuid": "d50554f493153be78f6740e18e598046", "type": "UserVm", "hypervisorType": "KVM", "memorySize": 8589934592, "cpuNum": 1, "allocatorStrategy": "LastHostPreferredAllocatorStrategy", "createDate": "Nov 14, 2017 9:20:57 AM", "lastOpDate": "Nov 14, 2017 9:20:57 AM", "state": "Running", "vmNics": [ { "uuid": "9856d36e40783d669b9e4f1de41d1a17", "vmInstanceUuid": "a1c07d683f693f6e9f2d7f9a499c7840", "usedIpUuid": "be02105c2a223492a91fb09ba664ecb1", "l3NetworkUuid": "d50554f493153be78f6740e18e598046", "ip": "192.168.1.10", "mac": "00:0c:29:bd:99:fc", "netmask": "255.255.255.0", "gateway": "192.168.1.1", "deviceId": 0, "state": "enable", "createDate": "Nov 14, 2017 9:20:57 AM", "lastOpDate": "Nov 14, 2017 9:20:57 AM" } ], "allVolumes": [ { "uuid": "24b9fcb69f123ad6b3ddfffed96d2882", "name": "Root-Volume-For-VM-a1c07d683f693f6e9f2d7f9a499c7840", "primaryStorageUuid": "ae47a25fd7cf3a349035d01060a8a224", "vmInstanceUuid": "a1c07d683f693f6e9f2d7f9a499c7840", "rootImageUuid": "5c07704333c532e8b402b6b3ddb89315", "installPath": "/zstack_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-24b9fcb69f123ad6b3ddfffed96d2882/24b9fcb69f123ad6b3ddfffed96d2882.qcow2", "type": "Root", "format": "qcow2", "size": 107374182400, "actualSize": 21474836480, "deviceId": 0, "state": "Enabled", "status": "Ready", "createDate": "Nov 14, 2017 9:20:57 AM", "lastOpDate": "Nov 14, 2017 9:20:57 AM" } ] } }变更历史
此 API 暂无变更历史记录。