功能介紹
更新 云服務(wù)器 元數(shù)據(jù)。
- 如果元數(shù)據(jù)中沒(méi)有待更新字段，則自動(dòng)添加該字段。
- 如果元數(shù)據(jù)中已存在待更新字段，則直接更新字段值。
- 如果元數(shù)據(jù)中的字段不在請(qǐng)求參數(shù)中，則保持不變
如果元數(shù)據(jù)中包含了敏感數(shù)據(jù)，您應(yīng)當(dāng)采取適當(dāng)?shù)拇胧﹣?lái)保護(hù)敏感數(shù)據(jù)，比如限制訪問(wèn)范圍、加密等。
接口約束
云服務(wù)器狀態(tài)（云服務(wù)器的OS-EXT-STS:vm_state屬性）必須是active，stopped，paused或者suspended。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/cloudservers/{server_id}/metadata
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請(qǐng)參見(jiàn)獲取項(xiàng)目ID。 |
|
server_id |
是 |
云服務(wù)器ID。 |
請(qǐng)求消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
說(shuō)明 |
|---|---|---|---|
|
metadata |
是 |
Object |
用戶自定義metadata鍵值對(duì)。 結(jié)構(gòu)體允許為空，取值為空時(shí)不更新數(shù)據(jù)。 鍵。 最大長(zhǎng)度255個(gè)Unicode字符，不能為空?？梢詾榇髮?xiě)字母（A-Z）、小寫(xiě)字母（a-z）、數(shù)字（0-9）、中劃線（-）、下劃線（_）、冒號(hào)（:）和小數(shù)點(diǎn)（.）。 值。 最大長(zhǎng)度為255個(gè)Unicode字符。 |
響應(yīng)消息
|
參數(shù) |
參數(shù)類型 |
說(shuō)明 |
|---|---|---|
|
metadata |
Object |
用戶自定義metadata鍵值對(duì)。 |
請(qǐng)求示例
更新云服務(wù)器的元數(shù)據(jù)為自定義的鍵值對(duì)。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/metadata
{
"metadata": {
"key": "value"
}
}
響應(yīng)示例
{
"metadata":{
"key":"value"
}
}
返回值
請(qǐng)參考通用請(qǐng)求返回值。
