# 更新裸金属服务器元数据（废弃）
#### 功能介绍
更新裸金属服务器的元数据。
- 如果元数据中没有待更新字段，则自动添加该字段。
- 如果元数据中已存在待更新字段，则直接更新字段值。
当前API已废弃，请使用"[更新裸金属服务器元数据 - UpdateBaremetalServerMetadata](https://support.huaweicloud.com/api-bms/bms_api_0631.html)"。
#### 约束
裸金属服务器状态（OS-EXT-STS:vm_state属性）必须是active，stopped，paused。
#### URI
POST /v2.1/{project_id}/servers/{server_id}/metadata
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                                            |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-bms/bms_api_appendix_03.html)。                      |
| server_id  | 是    | 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用[查询裸金属服务器列表（废弃）](https://support.huaweicloud.com/api-bms/bms_api_0709.html)获取。 |
   
#### 请求参数
| 参数       | 是否必选 | 参数类型   | 描述                                                              |
|:---|:---|:---|:---|
| metadata | 是    | Object | 用户自定义metadata键值对。详情请参见[表2]。 |
   
 表2metadata数据结构说明 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| 用户自定义字段键值对 | 是    | String | 用户自定义metadata键值对。 - 键、值长度均不大于255字节。  - 键名key不支持如下特殊字符： :\`\~!@#$%\^\&\*()=+\<,\>?/'";{\[\]}\|\\   - 键值value不支持如下特殊字符： \\"    |
   
#### 请求示例
更新ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器的元数据，其中自定义metadata键值对为key和value。
```
POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata
```
```
{
    "metadata": {
        "key": "value"
    }
}
```
#### 响应参数
| 参数       | 参数类型   | 描述                                                              |
|:---|:---|:---|
| metadata | Object | 用户自定义metadata键值对。详情请参见[表3]。 |
   
 表3metadata字段数据结构说明 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| 用户自定义字段键值对 | String | metadata键、值。 - 键、值长度大于0字节且小于256字节。  - 键值value不支持如下特殊字符： \\"    |
   
#### 响应示例
```
{
    "metadata": {
        "key": "value"
    }
}
```
#### 返回值
正常返回值：
| 返回值 | 说明           |
|:---|:---|
| 200 | 服务器已成功处理了请求。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。