本文导读

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

展开导读

文档首页/ 云硬盘 EVS/ API参考/ API/ 标准快照管理/ 查询快照一致性组列表

查询快照一致性组列表

更新时间：2025-07-21 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

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

调用方法

请参见如何调用API。

URI

GET /v5/{project_id}/snapshot-groups/detail

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释项目ID。约束限制不涉及。取值范围获取方法请参见"获取项目ID"。默认取值不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
id	否	String	指定的快照一致性组ID。
name	否	String	快照一致性组名称。最大支持255个字节。最小长度：0 最大长度：255
status	否	String	快照一致性组的状态。N的取值范围：1~3。取值如下： creating：创建中。 avaialble：创建成功。 error：创建失败。 deleting: 删除中。
tag_key	否	String	快照一致性组的标签的key。
tags	否	String	快照一致性组的标签的key/value对，例如{"key1":"value1"}
enterprise_project_id	否	String	快照一致性组的企业项目ID。
limit	否	Integer	返回结果个数限制。
offset	否	Integer	偏移量。
sort_key	否	String	返回结果按该关键字排序，支持id，status，size，created_at等关键字，默认为“created_at”。
sort_dir	否	String	返回结果按照降序或升序排列，默认为“desc”。降序：desc 升序：asc
server_id	否	String	云服务器ID。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制不涉及。取值范围不涉及。默认取值不涉及。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
snapshot_groups	Array of SnapshotGroupDetail objects

表5 SnapshotGroupDetail
参数	参数类型	描述
id	String	快照一致性组的ID。
created_at	String	快照一致性组的创建时间。
status	String	快照一致性组的状态。
updated_at	String	快照一致性组的更新时间。
name	String	快照一致性组的名称。
description	String	快照一致性组的描述。
enterprise_project_id	String	快照一致性组的企业项目id。
tags	Map<String,String>	快照一致性组的标签。
server_id	String	云服务器id。

状态码：400

表6 响应Body参数
参数	参数类型	描述
error	Error object	参数解释出现错误时，返回的错误信息。取值范围不涉及。

表7 Error
参数	参数类型	描述
code	String	参数解释出现错误时，返回的错误码。取值范围错误码和其对应的含义请参考错误码说明。
message	String	参数解释出现错误时，返回的错误消息。取值范围不涉及。

请求示例

无

响应示例

状态码：200

{
  "snapshot_groups" : [ {
    "id" : "82700157-fa53-46bf-a51f-255624275cbe",
    "name" : "testSnapshotGroup",
    "description" : "test",
    "project_id" : "dae4ff26f73b4b3395a0f650a979beae",
    "enterprise_project_id" : "testEpId",
    "status" : "available",
    "tags" : {
      "key1" : "value1",
      "key2" : "value2",
      "key3" : "value3"
    },
    "created_at" : "2025-04-10T09:40:12.204112",
    "updated_at" : "2025-04-10T09:40:12.607112",
    "server_id" : null
  } ]
}

状态码：400

Bad Request

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

状态码


状态码	描述
200	OK
400	Bad Request

错误码

请参见错误码。

父主题：标准快照管理

上一篇：查询单个快照一致性组

下一篇：查询快照一致性组个数

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

盘古Doer提问云社区提问