修改裸金属服务器指定元数据（OpenStack原生）

功能介绍

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

约束

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

URI

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

参数说明请参见表1。

请求消息

• 请求参数

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

  表2 meta数据结构说明

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

• 请求样例

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

  1 2 3 4 5

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

响应消息

• 响应参数

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

  表3 meta字段数据结构说明

  参数	参数类型	描述
  用户自定义字段键值对	String	用户自定义metadata键值对。 键、值长度均不大于255字节。

• 响应样例

  1 2 3 4 5

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

返回值

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

错误码

请参考错误码。