功能介紹
更新 云服務(wù)器 元數(shù)據(jù)。
- 如果元數(shù)據(jù)中沒(méi)有待更新字段,則自動(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)參見(jiàn)獲取項(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)求返回值。
