文档首页/ 弹性云服务器 ECS/ API参考/ 历史API/ 快照管理（OpenStack Nova API）/ 创建快照（废弃）
更新时间：2024-12-13 GMT+08:00
查看PDF
分享

创建快照（废弃）

功能介绍

创建卷快照。

当前API已废弃，请使用"创建云硬盘快照（OpenStack原生 v2）"。

接口约束

用户创建的快照名称不能使用autobk_snapshot为前缀。

URI

POST /v2.1/{project_id}/os-snapshots

参数说明请参见表1。
表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

display_description

否

String

快照的描述。

volume_id

是

String

卷ID。

display_name

否

String

云硬盘快照名称。

最大支持255个字节。

说明：

通过VBS对云硬盘创建备份时，同时会创建以autobk_snapshot_为名称前缀的快照，云硬盘控制台对此类快照会有操作限制。因此，建议您不要创建以autobk_snapshot_为名称前缀的快照，避免影响快照的正常使用。

force

否

Boolean

是否执行强制创建。force为true时，支持卷在in-use状态时创建快照。

响应消息

响应参数如表3所示。

表3 响应参数

参数

是否必选

参数类型

描述

id

是

String

卷快照ID，UUID格式

status

是

String

卷快照的状态

displayName

否

String

卷快照名称

displayDescription

否

String

卷快照描述信息

createdAt

是

String

卷快照创建时间

volumeId

是

String

快照所属的卷ID，UUID格式

size

是

Integer

卷快照大小

请求示例

POST https://{endpoint}/v2.1/d6c277ba8820452e83df36f33c9fa561/os-snapshots
{
	"snapshot": {
		"display_name": "test",
		"display_description": null,
		"volume_id": "ba5730ea-8621-4ae8-b702-ff0ffc12c209"
	}
}

响应示例

{
    "snapshot": 
        {
            "createdAt": "2016-05-20T16:54:14.981520", 
            "displayDescription": null, 
            "id": "b836dc3d-4e10-4ea4-a34c-8f6b0460a583",  
            "displayName": "test", 
            "size": 1, 
            "status": "creating", 
            "volumeId": "ba5730ea-8621-4ae8-b702-ff0ffc12c209"
        }
}

返回值

请参考通用请求返回值。