此操作用来查询指定的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状态：
说明 如果未配置，不返回该项。 |
| serverId | iSCSI Target的IQN所在的服务器ID。 |
| luns | 关联卷的属性，包含：lunName、number。 类型：数组 |
| lunName | 关联卷的名称。 |
| number | 卷编号。 |
| chap.name | CHAP认证名称。 |
| chap.status | CHAP认证状态：
|
| createTime | 创建iSCSI Target的时间，unix时间戳（UTC），精确到毫秒。 |
| serverIds | iSCSI Target对应的服务器ID（仅集群版支持）。 |
| num | Target所在的服务器数量（仅集群版支持）。 |
| reclaimPolicy | iSCSI Target的回收策略：
|
| status | iSCSI Target的状态：
仅iSCSI Target处于删除中会返回此项。 |
请求示例1
单机版：查询iSCSI Target名称为targeta的信息。
GET /rest/v1/block/target/targeta HTTP/1.1
Date: Thu, 28 Nov 2024 08:50:36 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.32:1443
Connection: keep-alive
响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 06d040d876de41f6b0cb1f6cd4a21e30
Connection: keep-alive
Content-Length: 356
Date: Thu, 28 Nov 2024 08:50:36 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"targetName": "targeta",
"maxSessions": 3,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.1",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"targetPortalIP": {
"ips": [
{
"ip": "10.1.1.10",
"port": 5000
}
],
"status": "Disabled"
},
"serverId": "hblock_1"
}
],
"luns": [
{
"lunName": "LUNa1",
"number": 0
}
],
"createTime": 1729751771424,
"num": 1,
"reclaimPolicy": "Retain"
}
}
请求示例2
集群版：查询iSCSI Target名称为target01的信息。
GET /rest/v1/block/target/target01 HTTP/1.1
Date: Thu, 28 Nov 2024 08:19:14 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.117:1443
Connection: keep-alive
响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: c97e1e4472194522a22bd6d1577480a2
Connection: keep-alive
Content-Length: 585
Date: Thu, 28 Nov 2024 08:19:14 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"targetName": "target01",
"maxSessions": 1,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.3",
"ips": [
{
"ip": "192.168.0.117",
"port": 3260
}
],
"serverId": "hblock_2"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.4",
"ips": [
{
"ip": "192.168.0.102",
"port": 3260
}
],
"targetPortalIP": {
"ips": [
{
"ip": "10.0.1.10",
"port": 3223
}
],
"status": "Disabled"
},
"serverId": "hblock_3"
}
],
"luns": [
{
"lunName": "lun01a",
"number": 0
},
{
"lunName": "lun01b",
"number": 1
}
],
"chap": {
"name": "test",
"status": "Disabled"
},
"createTime": 1732591782678,
"serverIds": [
"hblock_2",
"hblock_3"
],
"num": 2,
"reclaimPolicy": "Delete"
}
}
