创建云硬盘备份
功能介绍
从存储卷创建块存储备份。
前提条件
用户必须有足够的备份配额来创建一个备份。
URI
POST ``/v2/{tenant_id}/backups
| 参数 | 是否必选 | 描述 |
|---|---|---|
| tenant_id | 是 | 项目的id。 |
请求消息
| 参数 | 参数类型 | 是否必选 | 描述 |
|---|---|---|---|
| description | String | 否 | 备份的描述或为空。 |
| incremental | boolean | 否 | 备份模式。对于增量备份模式，有效值为true；对于完全备份模式，有效值为false。默认值为false。 |
| volume_id | String | 是 | 卷的id。 |
| force | boolean | 否 | 指示是否备份，即使卷已连接。默认值为false。 |
| name | String | 否 | 备份的名字。 |
请求示例
示例一：创建一个全量备份
{
"backup": {
"name": "backup-001",
"incremental":false,
"volume_id": "5a2432e5-84e1-4db6-895c-594ec389bf2f",
"description": "1234"，
"force":false
}
}响应消息
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 备份的id。 |
| links | array | 备份传输的链接。 |
| name | String | 备份的名称。 |
响应示例
{
"backup": {
"id": "d69ac1c5-dd68-4c9c-b23b-b1dc90b74299",
"links": [
{
"href": "http://cinder-api.openstack.svc.cluster.local:8776/v2/87aca7a4e69d4da09a3de67c28f3d48d/backups/d69ac1c5-dd68-4c9c-b23b-b1dc90b74299",
"rel": "self"
},
{
"href": "http://cinder-api.openstack.svc.cluster.local:8776/87aca7a4e69d4da09a3de67c28f3d48d/backups/d69ac1c5-dd68-4c9c-b23b-b1dc90b74299",
"rel": "bookmark"
}
],
"name": "006"
}
}恢复备份
功能介绍
将块存储备份还原到现有或新的块存储卷。
您必须指定UUID或卷的名称。 如果同时指定UUID和名称，则UUID优先。
URI
POST /v2/{tenant_id}/backups/{backup_id}/restore
| 参数 | 是否必选 | 描述 |
|---|---|---|
| tenant_id | 是 | 项目的id。 |
| backup_id | 是 | 云硬盘备份的id。 |
请求消息
| 参数 | 参数类型 | 是否必选 | 描述 |
|---|---|---|---|
| name | String | 否 | 云硬盘的名称。 |
| volume_id | String | 否 | 云硬盘的id。 |
| volume_type | String | 否 | 云硬盘的类型。 |
请求示例
示例一：将备份还原到云硬盘中
{
"restore": {
"name": "test-api-vm",
"volume_id": "5a2432e5-84e1-4db6-895c-594ec389bf2f",
"volume_type": "hdd"
}
}响应消息
| 参数 | 参数类型 | 描述 |
|---|---|---|
| backup_id | String | 云硬盘备份的id。 |
| volume_id | String | 云硬盘的id。 |
| volume_name | String | 云硬盘的名称。 |
响应示例
{
"restore": {
"backup_id": "d69ac1c5-dd68-4c9c-b23b-b1dc90b74299",
"volume_name": "test-api-vm",
"volume_id": "5a2432e5-84e1-4db6-895c-594ec389bf2f"
}
}列出备份
功能介绍
列出租户可以访问的块存储备份。
URI
GET /v2/{tenant_id}/backups
| 参数 | 是否必选 | 描述 |
|---|---|---|
| tenant_id | 是 | 项目的id。 |
请求消息
| 参数 | 参数类型 | 是否必选 | 描述 |
|---|---|---|---|
| limit | integer | 否 | 查询的最大个数限制 |
| marker | String | 否 | 最后一项的ID。 |
| sort_key | String | 否 | 按照云硬盘备份属性排序。 |
| sort_dir | String | 否 | 排序方向。 |
响应消息
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 云硬盘备份的id。 |
| links | array | 云硬盘备份传输的链接。 |
| name | String | 云硬盘备份的名称。 |
响应示例
{
"backups": [
{
"id": "d69ac1c5-dd68-4c9c-b23b-b1dc90b74299",
"links": [
{
"href": "http://cinder-api.openstack.svc.cluster.local:8776/v2/87aca7a4e69d4da09a3de67c28f3d48d/backups/d69ac1c5-dd68-4c9c-b23b-b1dc90b74299",
"rel": "self"
},
{
"href": "http://cinder-api.openstack.svc.cluster.local:8776/87aca7a4e69d4da09a3de67c28f3d48d/backups/d69ac1c5-dd68-4c9c-b23b-b1dc90b74299",
"rel": "bookmark"
}
],
"name": "006"
},
{
"id": "6c490122-3f9a-4fc1-b99e-8e6ea786dad7",
"links": [
{
"href": "http://cinder-api.openstack.svc.cluster.local:8776/v2/87aca7a4e69d4da09a3de67c28f3d48d/backups/6c490122-3f9a-4fc1-b99e-8e6ea786dad7",
"rel": "self"
},
{
"href": "http://cinder-api.openstack.svc.cluster.local:8776/87aca7a4e69d4da09a3de67c28f3d48d/backups/6c490122-3f9a-4fc1-b99e-8e6ea786dad7",
"rel": "bookmark"
}
],
"name": "006"
},
{
"id": "8f9a9328-8259-4e1b-9b91-0ded5b6323ea",
"links": [
{
"href": "http://cinder-api.openstack.svc.cluster.local:8776/v2/87aca7a4e69d4da09a3de67c28f3d48d/backups/8f9a9328-8259-4e1b-9b91-0ded5b6323ea",
"rel": "self"
},
{
"href": "http://cinder-api.openstack.svc.cluster.local:8776/87aca7a4e69d4da09a3de67c28f3d48d/backups/8f9a9328-8259-4e1b-9b91-0ded5b6323ea",
"rel": "bookmark"
}
],
"name": "006"
}
]
}删除一个备份
功能介绍
删除一个备份。
URI
DELETE /v2/{tenant_id}/backups/{backup_id}
| 参数 | 是否必选 | 描述 |
|---|---|---|
| tenant_id | 是 | 项目的id。 |
| backup_id | 是 | 云硬盘备份的id。 |
