此操作用来触发卷对应Target的主备切换。

注意
执行此操作后，客户端不需要进行任何操作。

请求语法

PUT /rest/v1/block/lun/lunName/switch HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization

请求参数

参数
描述
是否必须
lunName
卷名称。
类型：字符串
取值：长度范围是1~16，只能由字母、数字和短横线（-）组成，字母区分大小写，且仅支持以字母或数字开头。
是

响应结果

名称
描述
iSCSITargets
iSCSI Target属性集合。包含：iqn、status、ips。
类型：数组
iqn
Target IQN。
status
卷对应的Target的状态：
Active：主Target。
Standby：热备Target。
Unavailable：冷备Target。
ips
iSCSI Target的IP属性集合，包含：ip、port。
类型：数组
ip
iSCSI Target的IP。
port
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"
            }
        ]
    }
}