查询文件的快照信息

描述

查询指定文件的所有快照信息,

若指定UUID,则查询该文件的该UUID指定的快照信息

语法
Method Url
GET /SnapshotCloneService?Action=GetFileSnapshotInfo&Version=0.0.6&User=test&File=test&Limit=10&Offset=0
GET /SnapshotCloneService?Action=GetFileSnapshotInfo&Version=0.0.6&User=test&File=test&UUID=de06df66-b9e4-44df-ba3d-ac94ddee0b28
请求参数
名称 类型 是否必须 描述
Action string GetFileSnapinfo
Version string API版本号 0.0.6
User string 租户信息
File string 文件名称
Limit int 最大显示条数,默认为10
Offset int 偏移值,默认为0
UUID string 快照的uuid信息
响应
名称 类型 描述
Code string 错误码
Message string 错误信息
RequestId string 请求ID
TotalCount int 快照总个数
Snapshots Snapshot 快照信息列表

Snapshot类型说明

名称 类型 描述
UUID string 快照唯一ID
User string 租户信息
File string 文件名称
SeqNum uint32 快照版本号
Name string 快照名称
Time uint64 创建时间
FileLength uint32 文件大小(单位Byte)
Status enum 快照处理的状态(0:done, 1:pending, 2:deleteing, 3:errorDeleting, 4:canceling, 5:error)
Progress uint32 快照完成百分比
示例

request

  1. http://127.0.0.1:5555/SnapshotCloneService?Action=GetFileSnapshotInfo&Version=0.0.6&User=zjm&File=/zjm/test1&Limit=10
  2. response

HTTP/1.1 200 OK

Content-Length: xxx

{

​ “Code” : “0”,

​ “Message” : “Exec success.”,

​ “RequestId” : “xxx”,

​ “TotalCount”: 1,

​ “Snapshots”:

[

​ {

​ “File” : “/zjm/test1”,

​ “FileLength” : 10737418240,

​ “Name” : “snap1”,

​ “Progress” : 30,

​ “SeqNum” : 1,

​ “Status” : 1,

​ “Time” : 1564391913582677,

​ “UUID” : “de06df66-b9e4-44df-ba3d-ac94ddee0b28”,

​ “User” : “zjm”

​ }

]

}

错误码

见最后一节错误码表。