此操作用来迁移iSCSI Target，修改iSCSI Target对应的服务器。

说明
一次只允许迁移iSCSI Target对应的一个服务器。

注意
执行迁移iSCSI Target之前，需要保证集群处于working状态，同时目的服务器需要处于正常已连接状态。
目前仅支持强制迁移iSCSI Target，强制迁移iSCSI Target可能会造成数据丢失。
如果被迁移的iSCSI Target已被卷连接，且该卷已经被客户端挂载，迁移iSCSI Target前，需要客户端与原iSCSI Target IQN断开；迁移后，确保原iSCSI Target IQN不能被发现，客户端重新连接迁移后的iSCSI Target IQN。

请求语法

PUT /rest/v1/block/target/targetName/migrate?force=force HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization

{
    "server": [
        {
            "source": source_server_ID,
            "dest": dest_server_ID
        }
    ]
}

请求参数

参数
描述
是否必填
targetName
iSCSI Target名称。
类型：字符串
取值：长度范围是1~16，可以由小写字母、数字、句点（.）和短横线（-）组成，且仅支持以字母或数字开头。
是
force
是否强制迁移iSCSI Target。
注意
目前仅支持强制迁移iSCSI Target，强制迁移iSCSI Target可能会造成数据丢失。
类型：布尔
取值：true：强制迁移iSCSI Target。
是
source
iSCSI Target的源服务器ID。
类型：字符串
是
dest
iSCSI Target的目标服务器ID。
类型：字符串
是

响应结果

名称
描述
luns
卷的属性集合，包含：lunName、iSCSITargets、
类型：数组
lunName
关联卷的名称。
iSCSITargets
iSCSI Target属性集合。包含：iqn、status、ips、targetPortalIP。
类型：数组
iqn
iSCSI Target IQN。
status
卷对应的iSCSI 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属性集合，包含：ip、port。
类型：数组
targetPortalIP.ips.ip
iSCSI目标门户的IP地址。
说明：如果未配置，不返回该项。
targetPortalIP.ips.port
iSCSI目标门户的端口号。
说明：如果未配置，不返回该项。
targetPortalIP.status
iSCSI目标门户的状态：
Enabled：启用状态。
Disabled：禁用状态。

请求示例

迁移target01。

PUT /rest/v1/block/target/target01/migrate?force=true HTTP/1.1
Date: Thu, 4 Jul 2024 03: 23: 39 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 95
Host: 192.168.0.192: 1443 

{
    "server": [
        {
            "source": "hblock_1",
            "dest": "hblock_2"
        }
    ]
}

响应示例

HTTP/1.1 200 OK 
x-hblock-request-id: 4e88a225b1114c4ca3f2611e336ac431
Connection: keep-alive
Content-Type: application/json; charset=utf-8
Content-Length: 282
Date: Thu, 4 Jul 2024 03: 23: 39 GMT
Server: HBlock

{
    "data": {
        "luns": [
            {
                "lunName": "lun01a",
                "iSCSITargets": [
                    {
                        "iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.1",
                        "status": "Active",
                        "ips": [
                            {
                                "ip": "192.168.0.102",
                                "port": 3260
                            }
                        ]
                    },
                    {
                        "iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.2",
                        "status": "Unavailable",
                        "ips": [
                            {
                                "ip": "192.168.0.192",
                                "port": 3260
                            }
                        ]
                    }
                ]
            }
        ]
    }

说明
卷关联的iSCSI Target处于Unavailable状态，表示iSCSI Target正在从一个服务器迁移到集群其他服务器上，迁移过程，该iSCSI Target处于Unavailable状态。迁移完成后，iSCSI Target将变为Active或者Standby状态。