此操作用来触发卷对应Target的主备切换。
注意
执行此操作后,客户端不需要进行任何操作。
请求语法
PUT /rest/v1/block/lun/lunName/switch HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization
请求参数
参数 | 类型 | 描述 | 是否必须 |
---|---|---|---|
lunName | String | 卷名称。 取值:长度范围是1~16,只能由字母、数字和短横线(-)组成,字母区分大小写,且仅支持以字母或数字开头。 | 是 |
响应结果
名称 | 类型 | 描述 |
---|---|---|
iSCSITargets | Array of iSCSITarget | iSCSI Target属性集合,详见“表1 响应参数iSCSITarget说明”。 |
表1 响应参数iSCSITarget说明
名称 | 类型 | 描述 |
---|---|---|
iqn | String | Target IQN。 |
status | String | 卷对应的Target的状态:
|
ips | Array of ip | iSCSI Target的IP属性集合,详见“表2 响应参数ip说明”。 |
表2 响应参数ip说明
名称 | 类型 | 描述 |
---|---|---|
ip | String | iSCSI Target的IP。 |
port | Integer | iSCSI Target的端口号。 |
请求示例
对卷lun01a进行切换。
PUT /rest/v1/block/lun/lun01a/switch HTTP/1.1
Date: Fri, 10 Feb 2023 09: 42: 01 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.117: 1443
响应示例
HTTP/1.1 200 OK
x-hblock-request-id: 10d4e743ef08473fbe41cc61cd933844
Connection: keep-alive
Content-Length: 296
Date: Fri, 10 Feb 2023 09: 42: 01 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.3",
"status": "Unavailable",
"ips": [
{
"ip": "192.168.0.117",
"port": 3260
}
],
"serverId": "hblock_1"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.4",
"status": "Active",
"ips": [
{
"ip": "192.168.0.192",
"port": 3260
}
],
"serverId": "hblock_3"
}
]
}
}