功能介紹
更新 云服務(wù)器 元數(shù)據(jù)。
- 如果元數(shù)據(jù)中沒有待更新字段,則自動(dòng)添加該字段。
- 如果元數(shù)據(jù)中已存在待更新字段,則直接更新字段值。
- 如果元數(shù)據(jù)中的字段不再請(qǐng)求參數(shù)中,則保持不變。
接口約束
云服務(wù)器狀態(tài)(云服務(wù)器的OS-EXT-STS:vm_state屬性)必須是active,stopped,paused或者suspended。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v2.1/{project_id}/servers/{server_id}/metadata
參數(shù) |
是否必選 |
描述 |
---|---|---|
project_id |
是 |
項(xiàng)目ID。 獲取方法請(qǐng)參見獲取項(xiàng)目ID。 |
server_id |
是 |
云服務(wù)器ID。 |
請(qǐng)求消息
響應(yīng)消息
請(qǐng)求示例
更新指定云服務(wù)器元數(shù)據(jù)為自定義的鍵值對(duì)。
POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/metadata
{ "metadata": { "key": "value" } }
響應(yīng)示例
{ "metadata":{ "key":"value" } }
返回值
請(qǐng)參考通用請(qǐng)求返回值。