此操作用来查询指定卷。
请求语法
GET /rest/v1/block/lun/lunName HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization
请求参数
参数 描述 是否必须 lunName 卷名称。
说明：如果不填写此项，会返回所有卷信息。
类型：字符串
取值：长度范围是1~16，只能由字母、数字和短横线（-）组成，字母区分大小写，且仅支持以字母或数字开头。
否
响应结果
名称 描述 lunName 卷名称。 targetName Target名称。 status 卷的状态：
Enabled：卷处于启用状态。
Disabled：卷处于禁用状态。
Deleting：卷正在删除中。
DeleteFailed：卷删除失败。
Recovering：卷正在还原中。
RecoverFailed：卷还原失败。
capacity 卷容量，单位是GiB。 storageMode 卷的存储类型：
Local：本地模式，数据全部保留在本地。
Cache：缓存模式，本地保留部分热数据，全部数据异步存储到OOS中。
Storage：存储模式，本地保留全部数据，并异步存储到OOS中。
createTime 卷创建时间。unix时间戳（UTC），精确到毫秒。 iSCSITargets iSCSI Target属性集合。包含：iqn、status、ips、targetPortalIP、serverId。
类型：数组
iqn Target IQN。 iSCSITargets.status 卷对应的Target的状态：
Active：主Target。
Standby：热备Target。
Offline：离线Target。
Unavailable：冷备Target。
ips iSCSI Target的IP属性集合，包含：ip、port。
类型：数组
ip iSCSI Target的IP。 port iSCSI Target的端口号。 targetPortalIP.ips iSCSI目标门户的属性集合，包括：ip、port。
类型：数组
ip iSCSI目标门户的IP地址。 port iSCSI目标门户的端口号。 targetPortalIP.status iSCSI目标门户的状态：
Enabled：启用状态。
Disabled：禁用状态。
serverId IQN所在的服务器ID。 cloud.bucketName OOS存储桶的名称（仅上云卷支持）。 cloud.prefix OOS中的前缀名称（仅上云卷支持）。
如果未设置，则不显示此段。
cloud.accessKey OOS AccessKey（仅上云卷支持）。 cloud.endpoint OOS Endpoint（仅上云卷支持）。 cloud.objectSize 数据存储在OOS中的大小（仅上云卷支持）。 cloud.storageClass OOS的存储类型（仅上云卷支持）：
STANDARD：标准存储。
STANDARD_IA：低频访问存储。
cloud.compression 是否压缩数据上传至OOS（仅上云卷支持）：
Enabled：压缩数据上传至OOS。
Disabled：不压缩数据上传至对象OOS。
cloud.signVersion 上云签名认证的类型（仅上云卷支持）：
v2：V2签名认证。
v4：V4签名认证。
cloud.region Endpoint资源池所在区域（仅上云卷支持）。 config.localStorageClass 卷冗余模式（仅集群版支持）：
single-copy：单副本。
2-copy：两副本。
3-copy：三副本。
EC N+M。
config.minReplica 卷的最小副本数。 config.ECfragmentSize 分片大小。如果冗余模式为EC N+M，则会返回此项。 config.sectorSize 扇区大小，单位为字节。 config.highAvailability 高可用模式类型（仅集群版支持）：
ActiveStandby：主备，该卷关联对应Target下的所有IQN。
Disabled：禁用，该卷关联对应Target下的1个IQN。
config.writePolicy 卷的写策略：
WriteBack：回写，指数据写入到内存后即返回客户端成功，之后再异步写入磁盘。
WriteThrough：透写，指数据同时写入内存和磁盘，并在都写成功后再返回客户端成功。
WriteAround：绕写，指数据直接写到磁盘，不写入内存。
config.cachePool 缓存存储池（仅集群版支持）。 config.pool 存储池（仅集群版支持），表示最终存储池，卷数据最终落在该存储池内。 config.path 数据目录（仅单机版支持）。 number 卷编号。LUN在Target下的编号，由存储系统分配，对应客户端挂载存储设备时设备地址中的LUN ID。如果Target下只有一个LUN，LUN的编号一般为0。 uuid 卷的唯一识别码。 WWID 卷的唯一标识符。 deleteFailedReason 云上数据删除失败的原因，只有status是DeleteFailed的时候才返回该项。
请求示例1
单机版本地卷：查询卷luna1。
GET /rest/v1/block/lun/luna1 HTTP/1.1
Date: Tue, 14 May 2024 03: 24: 53 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.32: 1443
响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 658896b97e0b455b999dbbba8a2ef705
Connection: keep-alive
Content-Length: 453
Date: Tue, 14 May 2024 03: 24: 53 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "luna1",
"targetName": "targeta",
"status": "Enabled",
"capacity": 110,
"storageMode": "Local",
"createTime": 1715333463256,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/storage01"
},
"number": 0,
"uuid": "lun-uuid-6400cd65-60ec-4657-99dc-49eee6c1560b",
"WWID": "3300000002e39684c"
}
}
请求示例2
单机版上云卷：查询卷luna2。
GET /rest/v1/block/lun/luna2 HTTP/1.1
Date: Tue, 14 May 2024 03: 27: 53 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.32: 1443
响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: a7b2450d877f4d599854d93aeab0e565
Connection: keep-alive
Content-Length: 453
Date: Tue, 14 May 2024 03: 27: 53 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "luna2",
"targetName": "targeta",
"status": "Enabled",
"capacity": 110,
"storageMode": "Storage",
"createTime": 1715396757240,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"cloud": {
"bucketName": "hblocktest3",
"prefix": "hblock",
"accessKey": "cb22b08b1f9229f85874",
"endpoint": "https://oos-cn.ctyunapi.cn",
"objectSize": 1024,
"storageClass": "STANDARD",
"compression": "Enabled",
"signVersion": "v4",
"region": "cn"
},
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/storage01"
},
"number": 1,
"uuid": "lun-uuid-7c1d6013-4d72-40a9-ac47-132b083bd765",
"WWID": "33000000069ef2804"
}
}
请求示例3
集群版本地卷：查询卷lun01a。
GET /rest/v1/block/lun/lun01a HTTP/1.1
Date: Mon, 17 Jun 2024 03: 08: 03 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.110: 1443
响应示例3
HTTP/1.1 200 OK
x-hblock-request-id: 1214bb47679a4cac809b7a748fbe8f9b
Connection: keep-alive
Content-Length: 682
Date: Mon, 17 Jun 2024 03: 08: 03 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lun01a",
"targetName": "target01",
"status": "Enabled",
"capacity": 200,
"storageMode": "Local",
"createTime": 1717480736475,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.1",
"status": "Active",
"ips": [
{
"ip": "192.168.0.102",
"port": 3260
}
],
"serverId": "hblock_3"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.2",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.110",
"port": 3260
}
],
"serverId": "hblock_2"
}
],
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "default",
"ECfragmentSize": 16
},
"number": 0,
"uuid": "lun-uuid-43d3ef7f-6fcb-411e-a138-fea10f31add7",
"WWID": "33000000007feaf6e"
}
}
请求示例4
集群版上云卷：查询卷lun05a。
GET /rest/v1/block/lun/lun05a HTTP/1.1
Date: Mon, 17 Jun 2024 03: 16: 04 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.110: 1443
响应示例4
HTTP/1.1 200 OK
x-hblock-request-id: a05ae88f50384ac2afe1e1aa0dabf941
Connection: keep-alive
Content-Length: 933
Date: Mon, 17 Jun 2024 03: 16: 04 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lun05a",
"targetName": "target05",
"status": "Enabled",
"capacity": 50,
"storageMode": "Cache",
"createTime": 1718594129365,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target05.11",
"status": "Active",
"ips": [
{
"ip": "192.168.0.110",
"port": 3260
}
],
"serverId": "hblock_2"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target05.12",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.192",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"cloud": {
"bucketName": "hblocktest3",
"prefix": "stor2",
"accessKey": "cb22b08b1f9229f85874",
"endpoint": "https://oos-cn.ctyunapi.cn",
"objectSize": 1024,
"storageClass": "STANDARD",
"compression": "Enabled",
"signVersion": "v4",
"region": "cn"
},
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"cachePool": "default",
"pool": "pool2",
"ECfragmentSize": 16
},
"number": 0,
"uuid": "lun-uuid-b539d541-8df0-4432-ae47-35e40cb4595b",
"WWID": "33fffffffb5e9d6ba"
}
}
