此操作用来修改卷。
说明卷处于启用或禁用状态时可以修改;卷处于“删除中”,不能修改。
请求语法
本地卷
PUT /rest/v1/block/lun/lunName HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization
{
"config": {
"minReplica": minReplica,
"writePolicy": writePolicy
}
}
上云卷
PUT /rest/v1/block/lun/lunName HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization
{
"config": {
"minReplica": minReplica,
"writePolicy": writePolicy
},
"cloud": {
"compression": compression,
"accessKey": accessKey,
"secretKey": secretKey
"endpoint": endpoint,
"signVersion": signVersion,
"region": region
}
}
请求参数
参数 描述 是否必须 lunName 卷名称。 类型:字符串
取值:长度范围是1~16,只能由字母、数字和短横线(-)组成,字母区分大小写,且仅支持以字母或数字开头。
是 config.minReplica 最小副本数(仅集群版支持)。
对于副本模式的卷,假设卷副本数为X,最小副本数为Y(Y必须≤X),该卷每次写入时,至少Y份数据写入成功,才视为本次写入成功。对于EC N+M模式的卷,假设该卷最小副本数设置为Y(必须满足N≤Y≤N+M),必须满足总和至少为Y的数据块和校验块写入成功,才视为本次写入成功。
类型:整型
取值:对于副本卷,取值范围是[1, N],N为副本模式卷的副本数,默认值为1。对于EC卷,取值范围是[N, N+M],默认值为N。
否 config.writePolicy 卷的写策略。
类型:枚举
取值:
WriteBack:回写,指数据写入到内存后即返回客户端成功,之后再异步写入磁盘。适用于对性能要求较高,稳定性要求不高的场景。
WriteThrough:透写,指数据同时写入内存和磁盘,并在都写成功后再返回客户端成功。适用于稳定性要求较高,写性能要求不高,且最近写入的数据会较快被读取的场景。
WriteAround:绕写,指数据直接写到磁盘,不写入内存。适用于稳定性要求较高,性能要求不高,且写多读少的场景。
否 cloud.compression 是否压缩数据上传至OOS。
类型:枚举
取值:
Enabled:压缩数据上传至OOS。
Disabled:不压缩数据上传至OOS。
否 cloud.accessKey OOS的AccessKeyID。
注意OOS的AccessKeyID和SecretAccessKey如果要修改,必须同时修改。
类型:字符串
否 cloud.secretKey OOS的SecretAccessKey。
注意OOS的AccessKeyID和SecretAccessKey如果要修改,必须同时修改。
类型:字符串
否 cloud.endpoint 设置OOS Endpoint。
类型:字符串
否 cloud.signVersion 指定上云签名认证的类型。
类型:枚举
取值:
v2:V2签名认证。
v4:V4签名认证。
否 cloud.region 表示Endpoint资源池所在区域。
V4签名时,此项必填。
类型:字符串
否
请求示例1
修改卷lun8的写策略为WriteThrough。
PUT /rest/v1/block/lun/lun8 HTTP/1.1
Date: Fri, 29 Jul 2022 07: 29: 17 GMT
Host: 192.168.0.121: 1443
Content-Length: 53
Authorization: HBlock userName:signature
{
"config": {
"writePolicy": "WriteThrough"
},
}
响应示例1
HTTP/1.1 204 No Content
Date: Fri, 29 Jul 2022 07: 29: 18 GMT
Connection: keep-alive
x-hblock-request-id: 140a25c99a9a4efc87e561b44b595926
Server: HBlock
请求示例2
修改卷的最小副本数为3。
PUT /rest/v1/block/lun/lun01a HTTP/1.1
Date: Sat, 7 Oct 2023 07: 58: 35 GMT
Host: 192.168.0.117: 1443
Content-Length: 53
Authorization: HBlock userName:signature
{
"config": {
"minReplica": 3
}
}
响应示例2
HTTP/1.1 204 No Content
Date: Sat, 7 Oct 2023 07: 58: 35 GMT
Connection: keep-alive
x-hblock-request-id: 437f52eff9fe44a6ad9aae796beda55e
Server: HBlock
请求示例3
修改卷lun02a的上云信息。
PUT /rest/v1/block/lun/lun02a HTTP/1.1
Date: Thu, 9 May 2024 09: 12: 47 GMT
Host: 192.168.0.110: 1443
Content-Length: 271
Authorization: HBlock userName:signature
{
"cloud": {
"accessKey": "d0434d3e9e8dd462d6e0",
"secretKey": "***************************",
"endpoint": "oos-cn.ctyunapi.cn",
"signVersion": "v4",
"region": "cn",
"compression": "Enabled"
}
}
响应示例3
HTTP/1.1 204 No Content
Date: Thu, 9 May 2024 09:12:47 GMT
Connection: keep-alive
x-hblock-request-id: 01d8a27085444f6aaabbd3ebd16348db
Server: HBlock