删除卷的指定扩展属性（本地卷适用）
更新时间 2026-03-24 17:16:03
最近更新时间: 2026-03-24 17:16:03
本节主要介绍如何使用API删除卷的指定扩展属性。
此操作用来删除卷的指定扩展属性。
注意
卷状态为Deleting、DeleteFailed状态时，不允许删除卷的xattr。
卷无Active IQN时，不允许删除卷的xattr。
请求语法
PUT /rest/v1/block/lun/lunName/xattr HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization:authorization
{
"action": "delete",
"xattrKey":xattrKey,
"xattrInnerKey": "xattrInnerKey1, xattrInnerKey2…"
}请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
lunName | String | 指定要删除扩展属性的卷名称。 取值：长度范围是1~16，只能由字母、数字和短横线（-）组成，字母区分大小写，且仅支持以字母或数字开头。 | 是 |
| action | String | 操作类型。 取值：delete：删除单个卷指定的扩展属性。 | 是 |
| xattrKey | String | 指定卷的扩展属性的key值。 取值：
| 是 |
xattrInnerKey | String | 指定要删除xattrValue中的Key值，可以指定多个Key值，以英文逗号隔开。 说明 如果不指定此参数，则删除扩展属性key下的所有属性。 取值：长度范围是1~500，只能由字母、数字、汉字和特殊字符(~ ! @ $ ( ) _ + - ; . :)组成，特殊符号需转义。 | 否 |
请求示例
删除卷lun01a中xattrInnerKey为5b157817-cccf-471d-bca3-5cb7598bb376、27157817-cccf-471d-bca3-5cb7598bb389扩展属性。
PUT /rest/v1/block/lun/lun01a/xattr HTTP/1.1
Date: Tue, 03 Mar 2026 02:17:39 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 162
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443
{
"action": "delete",
"xattrKey": "OPENSTACK_META",
"xattrInnerKey": "5b157817-cccf-471d-bca3-5cb7598bb376,27157817-cccf-471d-bca3-5cb7598bb389"
}响应示例
HTTP/1.1 204 No Content
x-hblock-request-id: ff7f2e6f32c24ee68d1e838c263ac8c6
Connection: keep-alive
Date: Tue, 03 Mar 2026 02:17:39 GMT
Server: HBlock
