接口功能介绍
创建云硬盘备份。
接口约束
需要保证云硬盘备份存储库的剩余容量足够创建云硬盘备份。
URI
POST /v4/ebs-backup/create-backup
请求参数
请求头header参数
无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
diskID | 是 | String | 云硬盘ID | 0c582801-6b20-4e3a-956a-f3afbb5e9725 | |
regionID | 是 | String | 资源池ID | 81f7728662dd11ec810800155d307d5b | |
description | 否 | String | 云硬盘备份描述 | test-bak's description | |
repositoryID | 是 | String | 备份存储库ID | 9915c3f4-8d78-445a-a1da-d8d9287d506b | |
backupName | 是 | String | 备份名称,长度为 2~32 个字符,只能由数字、字母、-、_ 组成,不能以数字、-、_ 开头 | test-bak |
响应参数
参数 | 是否必填 | 类型 | 描述 | 示例 | 下级对象 |
---|---|---|---|---|---|
statusCode | 是 | Integer | 返回状态码(800为成功,900为失败) | 800 | |
message | 是 | String | 错误信息的英文描述 | SUCCESS | |
description | 是 | String | 错误信息的本地化描述(中文) | 成功 | |
returnObj | 否 | Object | 成功时返回对象 | returnObj | |
errorCode | 否 | String | 业务错误细分码,发生错误时返回 | 参考错误码 |
表 returnObj
参数名 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 资源池ID | 81f7728662dd11ec810800155d307d5b | |
backupID | 是 | String | 云硬盘备份ID | 59093d15-8a3c-53b9-b61b-484af10a3e97 | |
backupName | 是 | String | 云硬盘备份名称 | test-bak | |
backupStatus | 是 | String | 云硬盘备份状态,available-可用, error-失败,creating-创建中等 | creating | |
diskSize | 是 | Integer | 云硬盘大小,单位GB | 100 | |
backupSize | 是 | Integer | 云硬盘备份大小,单位Byte | 1024000 | |
description | 是 | String | 云硬盘备份描述 | test-bak's description | |
repositoryID | 是 | String | 备份存储库ID | 9915c3f4-8d78-445a-a1da-d8d9287d506b | |
repositoryName | 是 | String | 备份存储库名称 | test-repo | |
createdTime | 是 | Integer | 创建时间 | 1663136607 | |
updatedTime | 是 | Integer | 更新时间 | 1663136607 | |
finishedTime | 是 | Integer | 备份完成时间 | 1663136607 | |
restoredTime | 是 | Integer | 使用该云硬盘备份恢复数据时间 | 1663136607 | |
restoreFinishedTime | 是 | Integer | 使用该云硬盘备份恢复完成时间 | 1663136607 | |
freeze | 是 | Boolean | 是否冻结 | false | |
diskID | 是 | String | 云硬盘ID | 0c582801-6b20-4e3a-956a-f3afbb5e9725 | |
diskName | 是 | String | 云硬盘名称 | test-vol | |
encrypted | 是 | Boolean | 云硬盘是否加密 | false | |
diskType | 是 | String | 云硬盘类型,SATA-普通IO盘,SAS-高IO盘,SSD-超高IO盘,SSD-genric-通用型盘,FAST-SSD-极速云盘 | SATA | |
pass | 是 | Boolean | 是否支持PASS | false | |
instanceID | 是 | String | 挂载的云主机ID | f2338f53-81b1-4fef-72cc-9f72b5fe705c | |
instanceName | 是 | String | 挂载的云主机名称 | test-vm | |
projectID | 是 | String | 企业项目ID | 0 |
请求示例
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"diskID": "0c582801-6b20-4e3a-956a-f3afbb5e9725",
"description": "test-bak's description",
"repositoryID": "9915c3f4-8d78-445a-a1da-d8d9287d506b",
"backupName": "test-bak"
}
响应示例
{
"returnObj": {
"diskName": "test-vol-002",
"diskSize": 0,
"repositoryID": "9915c3f4-8d78-445a-a1da-d8d9287d506b",
"paas": false,
"backupSize": 0,
"regionID": "73f321ea-62ff-11ec-a8bc-005056898fe0",
"encrypted": false,
"repositoryName": "test-repository001",
"restoredTime": null,
"backupStatus": "creating",
"description": "test-bak's description",
"instanceID": "",
"createdTime": 1668033616,
"freeze": false,
"backupName": "test-bak",
"restoreFinishedTime": null,
"diskType": "SATA",
"diskID": "0c582801-6b20-4e3a-956a-f3afbb5e9725",
"updatedTime": 1668062416,
"finishedTime": null,
"backupID": "f7454119-867e-4317-b253-3ad47e35fcda",
"instanceName": "",
"projectID": "0"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
错误码
errorCode | 描述 |
---|---|
EbsBackup.RegionInfo.Empty | 查询资源池信息为空或资源池不存在,请确认资源池ID是否有效 |
EbsBackup.RegionInfo.AccessFailed | 查询资源池失败,请重试。如果多次尝试失败,请提交工单 |
EbsBackup.RegionInfo.DataDamaged | 查询资源池信息不符预期,请重试。如果多次尝试失败,请提交工单 |
EbsBackup.Parameter.InvalidBackupName | 请求参数错误:{错误原因} |
EbsBackup.RepositoryInfo.DataDamaged | 云硬盘备份存储库数据不符合预期 |
EbsBackup.RepositoryInfo.NotFound | 云硬盘备份存储库未找到 |
EbsBackup.Parameter.InvalidRepositoryID | 请求参数错误:{错误原因} |
EbsBackup.RepositoryInfo.AccessFailed | 查询云硬盘备份存储库失败 |
EbsBackup.RepositoryInfo.Expired | 云硬盘备份存储库过期 |
EbsBackup.DiskInfo.NotFound | 云硬盘未找到 |
EbsBackup.Parameter.InvalidDiskID | 请求参数错误:{错误原因} |
EbsBackup.Parameter.InvalidRegionID | 请求参数错误:{错误原因} |
EbsBackup.DiskInfo.InvalidState | 云硬盘当前状态,云硬盘备份不能进行该操作 |
Openapi.PatternCheck.NotValid | 请求参数无效:{错误原因} |