更新裸金属服务器元数据（OpenStack原生）

功能介绍

更新裸金属服务器的元数据。

约束

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

URI

POST /v2.1/{project_id}/servers/{server_id}/metadata

参数说明请参见表1。

请求消息

• 请求参数

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

  表2 metadata数据结构说明

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

• 请求样例

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

  1 2 3 4 5

  { "metadata": { "key": "value" } }

响应消息

• 响应参数

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

  表3 metadata字段数据结构说明

  参数	参数类型	描述
  用户自定义字段键值对	String	metadata键、值。 键、值长度大于0字节且小于255字节。 键值value不支持如下特殊字符： \"

• 响应样例

  1 2 3 4 5

  { "metadata": { "key": "value" } }

返回值

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

错误码

请参考错误码。