批量查詢一致性快照
更新時間 2025-05-26 15:15:00
最近更新時間: 2025-05-26 15:15:00
分享文章
本節主要介紹如何使用API批量查詢一致性快照。
此操作用來批量查詢一致性快照。
請求語法
GET /rest/v1/block/conssnap?filter=filter&range=i-j HTTP/1.1
Date:date
Host: ip:port
Authorization: authorization請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| filter | String | 查詢的過濾條件。 支持的過濾條件類型包括：
| 否 |
| range | String | 查詢一致性快照的范圍，格式為i-j，i和j為正整數，0<j-i<1000。按照一致性快照名稱進行排序，返回第i到第j的快照。 | 否 |
響應參數
| 名稱 | 類型 | 描述 |
|---|---|---|
| consistencySnapshot | Array of consistencySnapshot | 一致性快照信息集合，詳見“表1 響應參數consistencySnapshot說明”。 |
表1 響應參數consistencySnapshot說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| consistencySnapshotName | String | 一致性快照名稱。 |
| description | String | 一致性快照描述信息。 |
| lunSnapshotNumbers | Integer | 一致性快照的卷快照數。 |
| status | String | 一致性快照的狀態：
|
| createTime | Long | 一致性快照的創建時間。 |
| lunSnapshots | Array of lunSnapshot | 一致性快照中卷快照信息集合，詳見“表2 響應參數lunSnapshot說明”。 |
表2 響應參數lunSnapshot說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| snapshotName | String | 一致性快照中卷快照名稱。 |
| cloneNumbers | Integer | 卷快照關聯的鏈接克隆卷的個數。 |
請求示例
批量查詢一致性快照信息：一致性快照名稱中包含consistencysnapshot。
GET /rest/v1/block/conssnap?filter=consistencySnapshotName:consistencysnapshot HTTP/1.1
Date: Tue, 11 Mar 2025 02:22:20 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive響應示例
HTTP/1.1 200 OK
x-hblock-request-id: fcd556c82e19480ab050c200c631e89f
Date: Tue, 11 Mar 2025 02:22:20 GMT
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 719
Server: HBlock
{
"data": {
"consistencySnapshot": [
{
"consistencySnapshotName": "consistencysnapshot1",
"description": "consistency snapshot",
"lunSnapshotNumbers": 1,
"status": "Normal",
"createTime": 1741076297083,
"lunSnapshots": [
{
"snapshotName": "lun01a-snap20250304161817",
"cloneNumbers": 1
}
]
},
{
"consistencySnapshotName": "consistencysnapshot4",
"description": "The consistencysnapshot of lun01,lun01a,lun02,lun03.",
"lunSnapshotNumbers": 4,
"status": "Normal",
"createTime": 1741079382519,
"lunSnapshots": [
{
"snapshotName": "lun01-snap20250304170942",
"cloneNumbers": 1
},
{
"snapshotName": "lun02-snap20250304170942",
"cloneNumbers": 0
},
{
"snapshotName": "lun01a-snap20250304170942",
"cloneNumbers": 2
},
{
"snapshotName": "lun03-snap20250304170942",
"cloneNumbers": 0
}
]
}
]
}
}
