此操作用来批量修改卷的配置。
说明
卷处于启用或禁用状态时可以修改；卷处于“删除中”，不能修改。
请求语法
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 | 指定卷的操作内容。 类型：枚举值：
| 是 |
| lunList | 需要修改的卷列表。 类型：数组 取值：卷名称。 说明 如果此参数指定为空，即"lunList": []，或者不指定此参数，表示批量修改所有的卷。 | 否 |
| autoFailback | 修改是否根据指定的卷主备分布优先级自动进行主备切换（仅集群版支持），即针对卷主备状态，当高优先级的服务器恢复正常后，是否自动进行主备状态切换。 注意 action取值为setServerAffinity时生效。 类型：字符串 取值：
| 否 |
| priority | 修改卷主备分布优先级的服务器ID（仅集群版支持），根据系统指定的服务器ID顺序来选择卷的主备IQN。可以指定一个或者多个服务器ID，以英文逗号分开。 注意 action取值为setServerAffinity时生效，且priority和statusDriven互斥。如果为空数组，即[ ]，表示清空优先级设置。 类型：数组 取值：如果卷列表中指定一个卷，priority取值为服务器ID列表或者空数组；如果卷列表中指定多个（大于1）卷，或者卷列表为空，或者不指定卷列表，priority取值只能为空数组，或者不指定priority。 | 否 |
| statusDriven | 是否基于卷目前的主备状态进行优先级的设置。 注意 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": []
}
}
