此操作用來批量修改卷的配置。
說明
卷處于“刪除中”、“回滾中”，不能修改卷的配置。
請求語法
PUT /rest/v1/block/lun HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization
{
"action": action,
"lunList": [
lunName,lunName…
],
"autoFailback": autoFailback,
"priority": [
SeverID,ServerID…
],
"statusDriven": statusDriven
}請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| action | String | 指定卷的操作內容。 取值：
| 是 |
| lunList | Array of lun | 需要修改的卷列表。 取值：卷名稱。 說明 如果此參數指定為空，即"lunList": []，或者不指定此參數，表示批量修改所有的卷。 | 否 |
| autoFailback | String | 修改是否根據指定的卷主備分布優先級自動進行主備切換，即針對卷主備狀態，當高優先級的服務器恢復正常后，是否自動進行主備狀態切換。 注意 action取值為setServerAffinity時生效。 取值：
| 否 |
| priority | Array of priority | 修改卷主備分布優先級的服務器ID，系統根據指定的服務器ID順序來選擇卷的主備IQN。可以指定一個或者多個服務器ID，以英文逗號分開。 注意 action取值為setServerAffinity時生效，且priority和statusDriven互斥。如果為空數組，即[ ]，表示清空優先級設置。 取值：如果卷列表中指定一個卷，priority取值為服務器ID列表或者空數組；如果卷列表中指定多個（大于1）卷，或者卷列表為空，或者不指定卷列表，priority取值只能為空數組，或者不指定priority。 | 否 |
| statusDriven | Boolean | 是否基于卷目前的主備狀態進行優先級的設置，即根據卷的當前主備target（Active target、Standby target、Cold target）所在的服務器，設置卷主備分布優先級的服務器ID。 注意 action取值為setServerAffinity時生效。 取值：
| 否 |
請求示例1
清空卷lun01a、lun02a的優先級設置。
PUT /rest/v1/block/lun HTTP/1.1
Date: Wed, 15 Jan 2025 09:27:11 GMT
Host: 192.168.0.192:1443
Content-Length: 123
Authorization: HBlock userName:signature
{
"action": "setServerAffinity",
"lunList": [
"lun01a",
"lun02a"
],
"priority": []
}響應示例1
HTTP/1.1 202 Accepted
Date: Wed, 15 Jan 2025 09:27:11 GMT
Connection: keep-alive
x-hblock-request-id: bdb3c7eb8eac4342b161364f5034c3e9
Content-Length: 66
Server: HBlock
{
"data": {
"successLunList": [
"lun01a",
"lun02a"
],
"failedLunList": []
}
}請求示例2
對lun01a、lun02a、lun03a進行主備切換。
PUT /rest/v1/block/lun HTTP/1.1
Date: Wed, 15 Jan 2025 09:36:44 GMT
Host: 192.168.0.192:1443
Content-Length: 110
Authorization: HBlock userName:signature
{
"action": "switch",
"lunList": [
"lun01a",
"lun02a",
"lun03a"
]
}響應示例2
HTTP/1.1 202 Accepted
Date: Wed, 15 Jan 2025 09:36:44 GMT
Connection: keep-alive
x-hblock-request-id: 4e48e27a0db4495ca60b673ffd2cb3d5
Content-Length: 75
Server: HBlock
{
"data": {
"successLunList": [
"lun01a",
"lun02a"
],
"failedLunList": []
}
}
