本文导读

功能介绍
调用方法
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 云硬盘 EVS/ API参考/ API/ 标准快照管理/ 查询单个快照信息

查询单个快照信息

更新时间：2025-06-03 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

查询单个快照信息。标准快照当前只在部分区域支持，具体的区域列表请参见"功能总览"中快照页签下的区域信息。

调用方法

请参见如何调用API。

URI

GET /v5/{project_id}/snapshots/{snapshot_id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方法请参见"获取项目ID"。
snapshot_id	是	String	快照ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
snapshot	SnapshotDetailV5 object

表4 SnapshotDetailV5
参数	参数类型	描述
id	String	云硬盘快照ID。
name	String	云硬盘快照名称。名称以autobk_snapshot_为前缀的快照是创建云硬盘备份时系统自动创建的，请不要进行“删除云硬盘快照”和“回滚快照到云硬盘”操作。云硬盘快照名称。名称以autobk_snapshot_为前缀的快照是创建云硬盘备份时系统自动创建的，请不要进行“删除云硬盘快照”和“回滚快照到云硬盘”操作。
description	String	云硬盘快照描述信息。
created_at	String	云硬盘快照创建时间。时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX 云硬盘快照创建时间。时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
updated_at	String	云硬盘快照更新时间。
volume_id	String	快照所属的云硬盘ID。
size	String	云硬盘快照大小，单位为GiB。
status	String	云硬盘快照的状态，具体请参见云硬盘快照状态。
project_id	String	项目ID。
enterprise_project_id	String	快照所属的企业项目ID。
encrypted	Boolean	是否为加密快照。
cmk_id	String	快照所属的云硬盘ID的密钥ID。
category	String	快照类型，枚举值：standard/flash。
availability_zone	String	快照所属AZ。
tags	Map<String,String>	快照所属标签。
instant_access	Boolean	是否开启了快照快速可用功能。可能值： true：开启。仅SSD系列云盘支持开启该功能。 false：关闭。即快照为未开启快照极速可用功能的普通快照。
retention_at	String	快照保留的时间。
instant_access_retention_at	String	设置快照快速可用功能的保留时间，保留时间到期后自动关闭快照快速可用功能。默认与参数retention_at的值一致。
incremental	Boolean	是否增量快照。
snapshot_type	String	快照创建来源。取值范围： auto：自动创建快照。 user：手动创建快照。 copy：复制快照。
progress	String	快照创建进度，单位为百分比。
encrypt_algorithm	String	加密快照的加密算法。
snapshot_chains	Array of SnapshotChains objects	快照所属的快照链信息。
snapshot_group_id	String	快照所属的一致性快照组id。

表5 SnapshotChains
参数	参数类型	描述
id	String	快照链ID。
availability_zone	String	快照链所属云硬盘的可用区。
snapshot_count	Integer	快照链上的快照个数。
capacity	Integer	快照链的大小。
project_id	String	项目ID。
volume_id	String	快照链所属的云硬盘ID。
category	String	快照链的类型。
created_at	String	创建时间。
updated_at	String	更新时间。

状态码：400

表6 响应Body参数
参数	参数类型	描述
error	Error object	出现错误时，返回的错误信息。

表7 Error
参数	参数类型	描述
code	String	出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。
message	String	出现错误时，返回的错误消息。

请求示例

GET https://{endpoint}/v5/{project_id}/snapshots/{snapshot_id}

响应示例

状态码：200

{
  "snapshot" : {
    "id" : "308c213b-5e09-478e-a772-c81b20749fea",
    "status" : "available",
    "project_id" : "7c08fb7726964bf5b70a1f55a4cd6017",
    "size" : 1,
    "name" : null,
    "description" : null,
    "cmk_id" : null,
    "encrypted" : false,
    "created_at" : "2023-07-03T08:53:13.373010",
    "updated_at" : "2023-07-03T08:53:13.578010",
    "volume_id" : "66016b8d-b850-4afb-b2a4-d5903e9ffb59",
    "enterprise_project_id" : "0",
    "category" : "flash",
    "availability_zone" : "az2.dc2",
    "tags" : { },
    "instant_access" : true,
    "instant_access_retention_at" : "2023-07-07T08:53:13.373010",
    "retention_at" : "2023-07-07T08:53:13.373010"
  }
}

状态码：400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "EVS.XXX"
  }
}

状态码


状态码	描述
200	OK
400	Bad Request

错误码

请参见错误码。

父主题：标准快照管理

上一篇：更新快照信息

下一篇：查询快照详情列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问