此操作用來查詢指定卷。
請求語法
GET /rest/v1/block/lun/lunName HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| lunName | String | 卷名稱。 說明 如果不填寫此項,會返回所有卷信息。 取值:長度范圍是1~16,只能由字母、數字和短橫線(-)組成,字母區分大小寫,且僅支持以字母或數字開頭。 | 否 |
響應結果
| 名稱 | 類型 | 描述 |
|---|---|---|
| lunName | String | 卷名稱。 |
| targetName | String | target名稱。 |
| status | String | 卷的狀態:
|
| progress | Integer | 卷還原進度百分比。 僅卷狀態為Recovering時顯示。 |
| recoverFailedReason | String | 卷還原失敗的原因。 僅卷狀態為RecoverFailed時顯示。 |
| deleteFailedReason | String | 卷云上數據刪除失敗的原因。 僅卷狀態為DeleteFailed時顯示。 |
| wipeFailedReason | String | 卷清空失敗的原因。 僅卷狀態為WipeFailed時顯示。 |
| capacity | Integer | 卷容量,單位是GiB。 |
| storageMode | String | 卷的存儲類型:
|
| createTime | Long | 卷創建時間。unix時間戳(UTC),精確到毫秒。 |
| iSCSITargets | Array of iSCSITarget | iSCSI target屬性集合,詳見“表1 響應參數iSCSITarget說明”。 |
| cloud.bucketName | String | 存儲桶的名稱(僅上云卷支持)。 |
| cloud.prefix | String | 對象存儲中的前綴名稱(僅上云卷支持)。 如果未設置,則不顯示此段。 |
| cloud.accessKey | String | 對象存儲服務的Access Key(僅上云卷支持)。 |
| cloud.endpoint | String | 對象存儲Endpoint(僅上云卷支持)。 |
| cloud.objectSize | Integer | 數據存儲在對象存儲的大小(僅上云卷支持)。 |
| cloud.storageClass | String | 數據在對象存儲的存儲類型(僅上云卷支持):
|
| cloud.compression | String | 是否壓縮數據上傳至對象存儲(僅上云卷支持):
|
| cloud.signVersion | String | 上云簽名認證的類型(僅上云卷支持):
|
| cloud.region | String | Endpoint資源池所在區域(僅上云卷支持)。 |
| cloud.provider | String | 對象存儲服務名稱:
|
| config.localStorageClass | String | 卷冗余模式(僅集群版支持):
|
| config.minReplica | Integer | 卷的最小副本數(僅集群版支持)。 |
| config.ECfragmentSize | Integer | 分片大小(僅集群版支持)。如果冗余模式為EC N+M,則會返回此項。 |
| config.sectorSize | Long | 扇區大小,單位為字節。 |
| config.highAvailability | String | 高可用模式類型(僅集群版支持):
|
| config.writePolicy | String | 卷的寫策略:
|
| config.cachePool | String | 緩存存儲池(僅集群版支持)。 |
| config.pool | String | 存儲池(僅集群版支持),表示最終存儲池,卷數據最終落在該存儲池內。 |
| config.redundancyOverlap | Integer | 卷的折疊副本數(僅集群版支持)。 |
| config.serverAffinity | Object | 卷主備分布優先級設置,詳見“表5 響應參數config.serverAffinity說明”。 |
| config.qosPolicy | Object | 卷關聯的QoS策略信息,詳見表“6 響應參數config.qosPolicy說明”。 |
| config.qosPolicyforLUN | Object | 卷所在存儲池中卷的默認QoS策略信息(僅集群版支持),詳見“表7 響應參數config.qosPolicyforLUN”。 說明
|
| config.path | String | 數據目錄(僅單機版支持)。 |
| number | Long | 卷編號。LUN在target下的編號,由存儲系統分配,對應客戶端掛載存儲設備時設備地址中的LUN ID。如果target下只有一個LUN,LUN的編號一般為0。 |
| uuid | String | 卷的唯一識別碼。 |
| isClone | Boolean | 是否是克隆卷:
|
| sourceSnapshotName | String | 對應的快照名稱(僅克隆卷支持)。 |
| snapshots.snapshotNumbers | Integer | 卷的快照個數(僅本地卷支持)。 |
| snapshots.lunSnapshots | Array of lunSnapshot | 卷的快照信息集合(僅本地卷支持),詳見“表8 響應參數lunSnapshot/Children說明”。 |
| snapshots.snapshotSize | Long | 卷關聯的快照大小的總和(僅本地卷支持),即快照記錄的數據量。單位是字節。 注意 卷異常或上游快照刪除等因素可能導致快照大小波動。 |
| WWID | String | 卷的唯一標識符。 |
表1 響應參數iSCSITarget說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| iqn | String | iSCSI target IQN。 |
| status | String | 卷對應的target的狀態:
|
| ips | Array of ip | iSCSI target的IP屬性集合,詳見“表2 響應參數ip說明”。 |
| targetPortalIP | Array of targetPortalIP | iSCSI目標門戶,詳見“表3 響應參數targetPortalIP說明”。 |
| serverId | String | IQN所在的服務器ID。 |
表2 響應參數ip說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| ip | String | iSCSI target的IP。 |
| port | Integer | iSCSI target的端口號。 |
表3 響應參數targetPortalIP說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| ips | Array of ip | iSCSI目標門戶的IP屬性集合,詳見“表4 響應參數ip(iSCSI目標門戶的IP)說明”。 |
| status | String | iSCSI目標門戶的狀態:
|
表4 響應參數ip(iSCSI目標門戶的IP)說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| ip | String | iSCSI目標門戶的IP地址。 |
| port | Integer | iSCSI目標門戶的端口號。 |
表5 響應參數config.serverAffinity說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| autoFailback | String | 針對卷主備狀態,當高優先級的服務器恢復正常后,是否自動進行主備狀態切換(僅集群版支持):
|
| priority | Array of string | 卷主備分布優先級的服務器ID(僅集群版支持),系統根據指定的服務器ID順序來選擇卷的主備IQN。 |
表6 響應參數config.qosPolicy
| 名稱 | 類型 | 描述 |
|---|---|---|
| qosName | String | QoS策略名稱。 |
表7 響應參數config.qosPolicyforLUN
| 名稱 | 類型 | 描述 |
|---|---|---|
| qosName | String | QoS策略名稱。 |
| poolName | String | 存儲池名稱。 |
表8 響應參數lunSnapshot/Children說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| snapshotName | String | 快照名稱。 |
| description | Integer | 快照描述信息。 |
| lunCapacity | String | 創建快照時刻,源卷的容量。 |
| consistencySnapshotName | String | 所屬的一致性快照名稱。 說明 僅一致性快照的卷快照顯示。 |
| status | String | 快照的狀態:
|
| reclaimPolicy | String | 快照回收策略:
|
| createTime | Long | 快照的創建時間。 |
| basisofCurData | Boolean | 卷當前數據是否基于該快照:
|
| snapshotSize | Long | 快照大小,具體快照記錄的數據量。單位是字節。 注意 卷異常或上游快照刪除等因素可能導致快照大小波動。 |
| children | Array of children | 基于該快照創建的快照信息集合,參數解釋詳見本表。 |
請求示例1
單機版本地卷(非克隆卷):查詢卷luna1。
GET /rest/v1/block/lun/luna1 HTTP/1.1
Date: Thu, 21 Aug 2025 02:26:39 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443響應示例1
HTTP/1.1 200 OK
x-hblock-request-id: 3b6cf881f62c475bba53c294efd96f49
Connection: keep-alive
Content-Length: 935
Date: Thu, 21 Aug 2025 02:26:39 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "luna1",
"targetName": "targeta",
"status": "Normal",
"capacity": 100,
"storageMode": "Local",
"createTime": 1754375366308,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.1",
"status": "Active",
"ips": [
{
"ip": "192.168.0.66",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor01",
"reclaimPolicy": "Retain",
"qosPolicy": {
"qosName": "QoS1"
}
},
"number": 0,
"uuid": "lun-uuid-66e30bae-14d6-4900-b9a2-28b463dee255",
"isClone": false,
"snapshots": {
"snapshotNumbers": 2,
"lunSnapshots": [
{
"snapshotName": "luna1-snap1",
"lunCapacity": 100,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1755742271455,
"basisofCurData": false,
"children": [
{
"snapshotName": "luna1-sanp2",
"lunCapacity": 100,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1755743163988,
"basisofCurData": true,
"snapshotSize": 493932544
}
],
"snapshotSize": 0
}
],
"snapshotSize": 493932544
},
"WWID": "33fffffffd9744659"
}
}請求示例2
單機版本地卷(克隆卷):查詢卷luna1-clone1。
GET /rest/v1/block/lun/luna1-clone1 HTTP/1.1
Date: Thu, 04 Sep 2025 03:51:40 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443響應示例2
HTTP/1.1 200 OK
x-hblock-request-id: ff7ef330b99a4632825e1b10f648d6df
Connection: keep-alive
Content-Length: 815
Date: Thu, 04 Sep 2025 03:51:40 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "luna1-clone1",
"targetName": "targeta",
"status": "Normal",
"capacity": 100,
"storageMode": "Local",
"createTime": 1756362853649,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.1",
"status": "Active",
"ips": [
{
"ip": "192.168.0.66",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor01",
"reclaimPolicy": "Retain",
"qosPolicy": {
"qosName": "QoS1"
}
},
"number": 1,
"uuid": "lun-uuid-fd2492dd-f432-4fef-ab9b-861ecdbe598b",
"isClone": true,
"sourceSnapshotName": "luna1-sanp2",
"sourceLunName": "luna1",
"snapshots": {
"snapshotNumbers": 1,
"lunSnapshots": [
{
"snapshotName": "c1-snap1",
"lunCapacity": 100,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1756362893216,
"basisofCurData": true,
"snapshotSize": 4096
}
],
"snapshotSize": 4096
},
"WWID": "33000000076f232c3"
}
}請求示例3
單機版上云卷:查詢卷lunb1。
GET /rest/v1/block/lun/lunb1 HTTP/1.1
Date: Wed, 12 Mar 2025 03:10:41 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443響應示例3
HTTP/1.1 200 OK
x-hblock-request-id: eb12ed58e57b49d4b17e5de0c1d25ffc
Connection: keep-alive
Content-Length: 736
Date: Wed, 12 Mar 2025 03:10:41 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lunb1",
"targetName": "targetb",
"status": "Normal",
"capacity": 200,
"storageMode": "Cache",
"createTime": 1740650654198,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targetb.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.66",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"cloud": {
"bucketName": "hblocktest3",
"prefix": "lunb",
"accessKey": "8f129a5529f202811fd0",
"endpoint": "//oos-cn.ctyunapi.cn",
"objectSize": 1024,
"storageClass": "STANDARD",
"compression": "Enabled",
"signVersion": "v4",
"region": "cn",
"provider": "OOS"
},
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor01",
"reclaimPolicy": "Retain"
},
"number": 0,
"uuid": "lun-uuid-fc9a2f2c-c8bd-462b-8684-49e6e1650b1c",
"isClone": false,
"WWID": "33fffffff9449437a"
}
}請求示例4
集群版本地卷(非克隆卷):查詢卷lun01a。
GET /rest/v1/block/lun/lun01a HTTP/1.1
Date: Thu, 21 Aug 2025 02:14:23 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443響應示例4
HTTP/1.1 200 OK
x-hblock-request-id: 4de928edab1a49b3bd58470845d241d4
Connection: keep-alive
Content-Length: 2058
Date: Thu, 21 Aug 2025 02:14:23 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lun01a",
"targetName": "target01",
"status": "Normal",
"capacity": 200,
"storageMode": "Local",
"createTime": 1753783083428,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.65",
"port": 3260
}
],
"serverId": "hblock_1"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.1",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.67",
"port": 3260
}
],
"serverId": "hblock_3"
}
],
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "defaultpool",
"redundancyOverlap": 1,
"reclaimPolicy": "Retain",
"serverAffinity": {
"autoFailback": "Enabled"
},
"qosPolicy": {
"qosName": "QoS6"
},
"qosPolicyforLUN": {
"qosName": "QoS-Test",
"poolName": "defaultpool"
},
"ECfragmentSize": 16
},
"number": 0,
"uuid": "lun-uuid-816fdcce-7499-4fca-8a49-5d3bffc09603",
"isClone": false,
"snapshots": {
"snapshotNumbers": 5,
"lunSnapshots": [
{
"snapshotName": "snap1",
"lunCapacity": 200,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1753858410434,
"basisofCurData": false,
"children": [
{
"snapshotName": "lun01a-snap2",
"description": "This is the snapshot of lun01a.",
"lunCapacity": 200,
"status": "Normal",
"reclaimPolicy": "Delete",
"createTime": 1754039550600,
"basisofCurData": false,
"children": [
{
"snapshotName": "lun01a-snap20250801171358",
"lunCapacity": 200,
"consistencySnapshotName": "conssnap1",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1754039639013,
"basisofCurData": false,
"children": [
{
"snapshotName": "lun01a-snap20250813172013",
"lunCapacity": 200,
"consistencySnapshotName": "consistencysnapshot1",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1755076813517,
"basisofCurData": false,
"children": [
{
"snapshotName": "lun01a-snap20250813172049",
"lunCapacity": 200,
"consistencySnapshotName": "consistencysnapshot2",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1755076849373,
"basisofCurData": true,
"snapshotSize": 0
}
],
"snapshotSize": 118784
}
],
"snapshotSize": 200589312
}
],
"snapshotSize": 501301248
}
],
"snapshotSize": 93048832
}
],
"snapshotSize": 795058176
},
"WWID": "3300000000778b304"
}
}請求示例5
集群版本地卷(克隆卷):查詢卷Clone-2。
GET /rest/v1/block/lun/Clone-2 HTTP/1.1
Date: Thu, 21 Aug 2025 05:41:08 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443響應示例5
HTTP/1.1 200 OK
x-hblock-request-id: 7986a2596a944a9186a0365a04eb5607
Connection: keep-alive
Content-Length: 1628
Date: Thu, 21 Aug 2025 05:41:08 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "Clone-2",
"targetName": "target01",
"status": "Normal",
"capacity": 200,
"storageMode": "Local",
"createTime": 1754446965392,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.65",
"port": 3260
}
],
"serverId": "hblock_1"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.1",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.67",
"port": 3260
}
],
"serverId": "hblock_3"
}
],
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "defaultpool",
"redundancyOverlap": 1,
"reclaimPolicy": "Retain",
"serverAffinity": {
"autoFailback": "Enabled"
},
"qosPolicy": {
"qosName": "QoS6"
},
"qosPolicyforLUN": {
"qosName": "QoS-Test",
"poolName": "defaultpool"
},
"ECfragmentSize": 16
},
"number": 1,
"uuid": "lun-uuid-53c5ac7c-9a42-4eb8-b30a-d96109123b80",
"isClone": true,
"sourceSnapshotName": "lun01a-snap2",
"sourceLunName": "lun01a",
"snapshots": {
"snapshotNumbers": 3,
"lunSnapshots": [
{
"snapshotName": "clone-2-snap1",
"description": "This is clone-2 snapshot.",
"lunCapacity": 200,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1754881562607,
"basisofCurData": false,
"children": [
{
"snapshotName": "clone-2-snap2",
"lunCapacity": 200,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1754881791447,
"basisofCurData": false,
"snapshotSize": 0
},
{
"snapshotName": "Clone-2-snap20250813172013",
"lunCapacity": 200,
"consistencySnapshotName": "consistencysnapshot1",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1755076813524,
"basisofCurData": true,
"snapshotSize": 86016
}
],
"snapshotSize": 32768
}
],
"snapshotSize": 118784
},
"WWID": "3300000006ed69a48"
}
}請求示例6
集群版上云卷:查詢卷lun04a。
GET /rest/v1/block/lun/lun04a HTTP/1.1
Date: Wed, 12 Mar 2025 03:19:21 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443響應示例6
HTTP/1.1 200 OK
x-hblock-request-id: cb3ff4b6f5e84fe9a8937f41eb1b3303
Connection: keep-alive
Content-Length: 1004
Date: Wed, 12 Mar 2025 03:19:21 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lun04a",
"targetName": "target04",
"status": "Normal",
"capacity": 220,
"storageMode": "Cache",
"createTime": 1740708257052,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target04.15",
"status": "Active",
"ips": [
{
"ip": "192.168.0.65",
"port": 3260
}
],
"serverId": "hblock_1"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target04.16",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.64",
"port": 3260
}
],
"serverId": "hblock_2"
}
],
"cloud": {
"bucketName": "hblocktest3",
"accessKey": "8f129a5529f202811fd0",
"endpoint": "//oos-cn.ctyunapi.cn",
"objectSize": 1024,
"storageClass": "STANDARD",
"compression": "Enabled",
"signVersion": "v2",
"provider": "OOS"
},
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "default",
"redundancyOverlap": 1,
"reclaimPolicy": "Retain",
"serverAffinity": {
"autoFailback": "Enabled"
},
"ECfragmentSize": 16
},
"number": 0,
"uuid": "lun-uuid-194c91ec-1dd5-4d12-94ce-7bab1a898362",
"isClone": false,
"WWID": "33ffffffff4f9099b"
}
}