本文导读

功能介绍
调用方法
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 云硬盘 EVS/ API参考/ 历史API/ Cinder API/ 云硬盘元数据管理/ 更新云硬盘的单个元数据

更新云硬盘的单个元数据

更新时间：2025-06-03 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

更新云硬盘的单个元数据。

调用方法

请参见如何调用API。

URI

PUT /v3/{project_id}/volumes/{volume_id}/metadata/{key}

表1 路径参数
参数	是否必选	参数类型	描述
key	是	String	更新云硬盘的单个元数据
project_id	是	String	项目ID。获取方法请参见"获取项目ID"。
volume_id	是	String	云硬盘ID

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数
参数	是否必选	参数类型	描述
meta	是	Map<String,String>	需要更新的元数据信息。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
meta	Map<String,String>	键值对，云硬盘快照的单个元数据信息。

状态码：400

表5 响应Body参数
参数	参数类型	描述
error	Error object	出现错误时，返回的错误信息。

表6 Error
参数	参数类型	描述
code	String	出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。
message	String	出现错误时，返回的错误消息。

请求示例

PUT https://{endpoint}/v3/{project_id}/volumes/{volume_id}/metadata/{key}

{
  "meta" : {
    "key1" : "value1"
  }
}

响应示例

状态码：200

{
  "meta" : {
    "key1" : "value1"
  }
}

状态码：400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

状态码


状态码	描述
200	OK
400	Bad Request

错误码

请参见错误码。

父主题：云硬盘元数据管理

上一篇：更新云硬盘的单个元数据（废弃）

下一篇：更新云硬盘的元数据（废弃）

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问