更新时间:2024-04-18 GMT+08:00
更新云服务器元数据
功能介绍
更新云服务器元数据。
- 如果元数据中没有待更新字段,则自动添加该字段。
- 如果元数据中已存在待更新字段,则直接更新字段值。
- 如果元数据中的字段不再请求参数中,则保持不变。
接口约束
云服务器状态(云服务器的OS-EXT-STS:vm_state属性)必须是active,stopped,paused或者suspended。
URI
POST /v2.1/{project_id}/servers/{server_id}/metadata
请求消息
请求参数如表2所示。
响应消息
响应参数如表3所示。
请求示例
更新指定云服务器元数据为自定义的键值对。
POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/metadata { "metadata": { "key": "value" } }
响应示例
{ "metadata":{ "key":"value" } }
返回值
请参考通用请求返回值。
父主题: 元数据管理