查询快照详情
更新时间:2024-12-30
该接口用于用户通过指定快照ID查询单个快照的详细信息。
请求结构
GET /v1/snapshot/{snapshotId} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
snapshotId | String | 是 | URL参数 | 待查询的快照ID |
返回头域
除公共头域,无其它特殊头域。
返回参数
SnapshotModel
参数名称 | 类型 | 描述 |
---|---|---|
snapshotId | String | 快照ID |
name | String | 快照名称,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。 |
regionId | String | 所在regionId |
sizeInGB | int | 快照大小,单位是GB |
status | SnapshotStatus | 快照状态。创建中creating,已创建 created,回滚中rollbacking, 删除中 deleting |
createMethod | String | 快照创建方式,手动创建MANUAL,自动创建AUTO |
cdsId | String | 源磁盘cdsId,为空表示相关磁盘已释放 |
cdsName | String | 源磁盘cds名称 |
cdsStatus | String | 源磁盘cds状态, 已挂载mounted,运行中running,创建中starting,异常exception |
instanceId | String | 虚机实例ID,系统盘快照时有值 |
type | String | 类型: 系统盘system,数据盘data |
createTime | String | 快照创建时间,符合BCE规范的日期格式 |
错误码
请参照错误返回章节的内容。
请求示例
GET /v1/snapshot/snp-cn-jiangmen-ct-wwchfddhj1zn HTTP/1.1
Host: bec.baidubce.com
Authorization: auth string
返回示例
HTTP/1.1 200 OK
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"snapshotId": "snp-cn-jiangmen-ct-wwchfddhj1zn",
"name": "test-snapshot-743",
"regionId": "cn-jiangmen-ct",
"cdsId": "cds-disk-vm-rnmof0pu-cn-jiangmen-ct-ytn6g",
"cdsName": "disk-cds",
"sizeInGB": 3,
"status": "created",
"createMethod": "MANUAL",
"type": "data",
"createTime": "2024-03-04T11:40:07Z"
}