云硬盘快照

创建云硬盘快照

功能介绍

创建一个云硬盘快照。
创建卷快照，它是一个时间点，完整的卷副本。您可以从快照创建卷。

前提条件

用户必须有足够的快照配额来创建一个快照。

URI

POST /v2/{tenant_id}/snapshots

参数	是否必选	描述
tenant_id	是	项目id。

请求消息

参数	参数类型	是否必选	描述
volume_id	String	是	卷的id。
force	boolean	否	指示是否创建快照，即使卷已连接。默认值为false。
description	String	否	快照的描述或为空。
name	String	否	快照的名称。

请求示例

示例一：创建快照

{
	"snapshot": {
		"name": "snap-001",
	    "force": false,
	    "volume_id": "5a2432e5-84e1-4db6-895c-594ec389bf2f",
	    "description": "1234"
	}	   
}

响应消息

参数	参数类型	描述
status	String	快照的状态。
description	String	快照的描述信息或为空。
created_at	String	更新资源的日期和时间。 日期和时间戳格式为ISO 8601： CCYY-MM公司-直径：mm：ss±hh：毫米 例如，2015-08-27T09:49:58-05:00。 ±hh:mm值（如果包括在内）是从UTC偏移的时区。在上一个示例中，偏移值为-05:00。 如果未设置更新的日期和时间戳，则其值为空。
name	String	快照的名称
volume_id	String	卷的id。
metadata	object	快照的一个或多个元数据键和值对（如果有）。
id	String	快照的id。
size	integer	快照的大小。单位为：GB

响应示例

{
"snapshot": {
"status": "creating",
"size": 1,
"metadata": {},
"name": "snap-001",
"volume_id": "5a2432e5-84e1-4db6-895c-594ec389bf2f",
"created_at": "2021-02-23T07:35:19.458462",
"description": "1234",
"id": "57afdbe3-b1ae-421d-bb96-cd5740d7796d",
"updated_at": null
}
}

列出快照

功能介绍

列出租户可以访问的所有块存储快照的详细信息。

URI

GET /v2/{tenant_id}/snapshots

参数	是否必选	描述
tenant_id	是	项目id。

请求消息

参数	参数类型	是否必选	描述
limit	integer	否	查询的最大个数限制
marker	String	否	最后一项的ID。
sort_key	String	否	按照云硬盘快照属性排序。
sort_dir	String	否	排序方向。

响应消息

参数	参数类型	描述
status	String	云硬盘快照的状态
description	String	云硬盘快照的描述信息。
created_at	String	云硬盘快照的创建时间。
name	String	云硬盘快照的名称。
volume_id	String	云硬盘的id。
metadata	object	快照的一个或多个元数据键和值对（如果有）。
id	String	云硬盘快照的id。
size	integer	云硬盘快照的大小。
updated_at	String	云硬盘快照的更新时间。

响应示例

{
    "snapshots": [
        {
            "status": "available",
            "size": 1,
            "metadata": {},
            "name": "snap-001",
            "volume_id": "5a2432e5-84e1-4db6-895c-594ec389bf2f",
            "created_at": "2021-02-23T07:35:19.000000",
            "description": "1234",
            "id": "57afdbe3-b1ae-421d-bb96-cd5740d7796d",
            "updated_at": "2021-02-23T07:35:21.000000"
        },
        {
            "status": "available",
            "size": 1,
            "metadata": {},
            "name": "snap-1",
            "volume_id": "5a2432e5-84e1-4db6-895c-594ec389bf2f",
            "created_at": "2021-02-23T07:23:16.000000",
            "description": "123456",
            "id": "67a33dd2-ae58-4439-a7b8-3f135a72fa97",
            "updated_at": "2021-02-23T07:23:17.000000"
        },
    ]
}

显示快照详细信息

功能介绍

显示一个快照的详细信息。

URI

GET /v2/{tenant_id}/snapshots/{snapshot_id}

参数	是否必选	描述
tenant_id	是	项目id。
snapshot_id	是	云硬盘快照的id。_

响应消息

参数	参数类型	描述
status	String	云硬盘快照的状态。
os-extended-snapshot-attributes:progress	integer	生成进度的百分比值。
description	String	云硬盘快照的描述信息。
created_at	String	云硬盘快照的创建时间。
name	String	云硬盘快照的名称。
volume_id	String	云硬盘的id。
os-extended-snapshot-attributes:project_id	String	所属项目的UUID。
size	integer	云硬盘快照的大小。
id	String	云硬盘快照的id。
metadata	object	快照的一个或多个元数据键和值对（如果有）。
updated_at	String	云硬盘快照的更新时间。

响应示例

{
    "snapshot": {
        "status": "available",
        "description": "1234",
        "updated_at": "2021-02-23T07:35:21.000000",
        "volume_id": "5a2432e5-84e1-4db6-895c-594ec389bf2f",
        "id": "57afdbe3-b1ae-421d-bb96-cd5740d7796d",
        "size": 1,
        "os-extended-snapshot-attributes:progress": "100%",
        "name": "snap-001",
        "os-extended-snapshot-attributes:project_id": "87aca7a4e69d4da09a3de67c28f3d48d",
        "created_at": "2021-02-23T07:35:19.000000",
        "metadata": {}
    }
}

删除快照

功能介绍

删除快照。

URI

DELETE /v2/{tenant_id}/snapshots/{snapshot_id}

参数	是否必选	描述
tenant_id	是	项目id。
snapshot_id	是	云硬盘快照的id。