觸發卷對應Target的主備切換（集群版適用）
更新時間 2025-09-29 17:49:35
最近更新時間: 2025-09-29 17:49:35
分享文章
本節主要介紹如何使用API觸發卷對應target的主備切換。
此操作用來觸發卷對應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"
}
]
}
}
