文档首页/ 云硬盘 EVS/ API参考/ Cinder API/ 快照管理/ CreateSnapshotV5
更新时间：2024-10-28 GMT+08:00
在线调试
CLI示例
查看PDF
分享

CreateSnapshotV5

功能介绍

创建standard快照。

调用方法

请参见如何调用API。

URI

POST /v5/{project_id}/snapshots

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

snapshot

是

CreateStandardSnapshot object
表3 CreateStandardSnapshot

参数

是否必选

参数类型

描述

volume_id

是

String

云硬盘id

name

否

String

云硬盘快照名称。最大支持64个字符。

description

否

String

云硬盘快照描述，最大支持85个字符。

tags

否

Map<String,String>

云硬盘快照的标签

enterprise_project_id

否

String

云硬盘快照的企业项目id

instant_access

否

Boolean

是否开启快速可用功能，默认为false，表示不开启

retention_days

否

Integer

设置快照的保留时间，单位为天。保留时间到期后快照会被自动释放，取值范围：1~65536。

默认值：空，表示快照不会被自动释放。

instant_access_retention_days

否

Integer

设置快照快速可用功能的保留时间，保留时间到期后快照将自动释放。该参数在instance_access=true时生效。单位：天。取值范围：1~65535。

默认与参数retention_days的值一致。

incremental

否

Boolean

是否创建增量快照

响应参数

状态码： 202

表4 响应Body参数

参数

参数类型

描述

job_id

String

任务ID

snapshot_id

String

快照ID

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时，返回的错误信息。
表6 Error

参数

参数类型

描述

code

String

出现错误时，返回的错误码。

错误码和其对应的含义请参考错误码说明。

message

String

出现错误时，返回的错误消息。

请求示例

POST https://{endpoint}/v5/{project_id}/snapshots

{
  "snapshot" : {
    "volume_id" : "2c194dde-7de5-4529-a141-49f48181f411",
    "name" : "test_name",
    "description" : "test description",
    "enterprise_project_id" : "94f1ea84-1428-49b6-9920-8a9b8a29e4ca"
  }
}

响应示例

状态码： 202

Accepted

{
  "job_id" : "ee62a0c1e79c4e11be5adc17a49f69ef",
  "snapshot_id" : "bb02c803-55ac-4e84-9c80-60d352199d7d"
}

状态码： 400

Bad Request

{
  "error" : {
    "code" : "string",
    "message" : "string"
  }
}

状态码

状态码

描述

202

Accepted

400

Bad Request

错误码

请参见错误码。

父主题： 快照管理

相关文档