此操作用来修改卷。

说明
卷处于启用或禁用状态时可以修改；卷处于“删除中”，不能修改。

请求语法

本地卷

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