Loading
close

云硬盘快照

time 更新时间:2022-04-26 20:29:15

创建云硬盘快照

功能介绍

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

前提条件

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

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。
此篇文章对你是否有帮助?
没帮助
locked-file

您暂无权限访问该产品