修改裸金属服务器指定元数据（废弃）_裸金属服务器元数据管理（OpenStack Nova API）_历史API_API参考

修改裸金属服务器指定元数据。

裸金属服务器状态（OS-EXT-STS:vm_state属性）必须是active、stopped、paused。

PUT /v2.1/{project_id}/servers/{server_id}/metadata/{key}

参数说明请参见表1。

表1 参数说明
参数	是否必选	描述
project_id	是	项目ID。获取方式请参见获取项目ID。
server_id	是	裸金属服务器ID。可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器详情列表 - ListBareMetalServers获取。
key	是	待修改的裸金属服务器metadata键值。

参数	是否必选	参数类型	描述
meta	是	Object	用户自定义metadata键值对。详情请参见表2。

表2 meta数据结构说明
参数	是否必选	参数类型	描述
用户自定义字段键值对	是	String	用户自定义metadata键值对。键、值长度均不大于255字节。键名key不支持如下特殊字符： :`~!@#$%^&*()=+<,>?/'";{[]}\|\ 键值value不支持如下特殊字符： \"

修改ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器的元数据，其中自定义metadata键值对为key和value。

     PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata/{key}

     {
    "meta": {
        "key": "value"
    }
}
 
 
  

参数	参数类型	描述
meta	Object	用户自定义metadata键值对。详情请参见表3。

表3 meta字段数据结构说明
参数	参数类型	描述
用户自定义字段键值对	String	用户自定义metadata键值对。键、值长度均不大于255字节。

     {
    "meta": {
        "key": "value"
    }
} 
 
 
  

正常返回值：

返回值	说明
200	服务器已成功处理了请求。

其他返回值请参考状态码。

请参考错误码。

修改裸金属服务器指定元数据（废弃）