此操作用来查询指定的iSCSI Target。
请求语法
GET /rest/v1/block/target/targetName HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization
请求参数
参数 描述 是否必须 targetName iSCSI Target名称。
说明:如果不填写此项,会返回所有Target信息。
类型:字符串
取值:长度范围是1~16,可以由小写字母、数字、句点(.)和短横线(-)组成,且仅支持以字母或数字开头。
否
响应结果
名称 描述 targetName iSCSI Target名称。 maxSessions iSCSI Target下每个IQN允许建立的最大会话数。 iSCSITargets iSCSI Target属性集合。包含:iqn、ips、targetPortalIP、serverId。
类型:数组
iqn iSCSI Target IQN。 ips iSCSI Target的IP属性集合,包含:ip、port。
类型:数组
ip iSCSI Target的IP。 port iSCSI Target的端口号。 targetPortalIP.ips iSCSI目标门户IP属性集合,包含:ip、port。
类型:数组
ip iSCSI目标门户IP。
说明如果未配置,不返回该项。
port iSCSI目标门户端口号。
说明如果未配置,不返回该项。
targetPortalIP.status iSCSI目标门户IP状态:
Enabled:启用状态。
Disabled:停用状态。
说明如果未配置,不返回该项。
serverId iSCSI Target的IQN所在的服务器ID。 luns 关联卷的属性,包含:lunName、number。
类型:数组
lunName 关联卷的名称。 number 卷编号。 chap.name CHAP认证名称。 chap.status CHAP认证状态:
Enabled:启用CHAP认证。
Disabled:禁用CHAP认证。
createTime 创建iSCSI Target的时间,unix时间戳(UTC),精确到毫秒。 serverIds iSCSI Target对应的服务器ID(仅集群版支持)。 num Target所在的服务器数量(仅集群版支持)。
请求示例1
单机版:查询iSCSI Target名称为targeta的信息。
GET /rest/v1/block/target/targeta HTTP/1.1
Date: Thu,28 Sep 2023 09: 17: 10 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.32: 1443
Connection: keep-alive
响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 8f4d4a6648aa49daa3e9a3b2e6793678
Connection: keep-alive
Content-Length: 332
Date: Thu, 28 Sep 2023 09: 17: 10 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"targetName": "targeta",
"maxSessions": 1,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.2",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"targetPortalIP": {
"ips": [
{
"ip": "10.1.1.10",
"port": 20430
}
],
"status": "Disabled"
},
"serverId": "hblock_1"
}
],
"luns": [
{
"lunName": "luna1",
"number": 0
}
],
"createTime": 1695891789350,
"num": 1
}
}
请求示例2
集群版:查询iSCSI Target名称为target01的信息。
GET /rest/v1/block/target/target01 HTTP/1.1
Date: Thu, 28 Sep 2023 09:17:39 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.117:1443
Connection: keep-alive
响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: 5d8358567a474c0cadf4be1b808ce684
Connection: keep-alive
Content-Length: 692
Date: Thu, 28 Sep 2023 09: 17: 39 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"targetName": "target01",
"maxSessions": 10,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.3",
"ips": [
{
"ip": "192.168.0.117",
"port": 3260
}
],
"targetPortalIP": {
"ips": [
{
"ip": "10.0.1.10",
"port": 10011
}
],
"status": "Disabled"
},
"serverId": "hblock_1"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.4",
"ips": [
{
"ip": "192.168.0.102",
"port": 3260
}
],
"serverId": "hblock_2"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.5",
"ips": [
{
"ip": "192.168.0.192",
"port": 3260
}
],
"serverId": "hblock_3"
}
],
"luns": [
{
"lunName": "lun01a",
"number": 0
},
{
"lunName": "lun01b",
"number": 1
}
],
"chap": {
"name": "chap-test",
"status": "Disabled"
},
"createTime": 1695806252000,
"serverIds": [
"hblock_1",
"hblock_2",
"hblock_3"
],
"num": 3
}
}