查询文件的快照信息
描述
查询指定文件的所有快照信息,
若指定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
http://127.0.0.1:5555/SnapshotCloneService?Action=GetFileSnapshotInfo&Version=0.0.6&User=zjm&File=/zjm/test1&Limit=10
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”
}
]
}
错误码
见最后一节错误码表。