華為云計(jì)算 云知識(shí) 設(shè)置云服務(wù)器元數(shù)據(jù)NovaCreateServerMetadata
設(shè)置云服務(wù)器元數(shù)據(jù)NovaCreateServerMetadata

 

功能介紹

設(shè)置彈性 云服務(wù)器 的元數(shù)據(jù)信息。

將刪除目前彈性云服務(wù)器的所有元數(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

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

參數(shù)說明請(qǐng)參見表1。
表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

獲取方法請(qǐng)參見獲取項(xiàng)目ID。

server_id

云服務(wù)器ID。

請(qǐng)求消息

請(qǐng)求參數(shù)如表2所示。

表2 請(qǐng)求參數(shù)

參數(shù)

參數(shù)類型

是否必選

描述

metadata

Object

用戶自定義metadata鍵值對(duì)。

鍵。

最大長度255個(gè)Unicode字符,不能為空??梢詾榇髮懽帜福ˋ-Z)、小寫字母(a-z)、數(shù)字(0-9)、中劃線(-)、下劃線(_)、冒號(hào)(:)和小數(shù)點(diǎn)(.)。

值。

最大長度為255個(gè)Unicode字符。

響應(yīng)消息

響應(yīng)參數(shù)如表3所示。

表3 響應(yīng)參數(shù)

參數(shù)

參數(shù)類型

描述

metadata

Object

用戶自定義metadata鍵值對(duì)。

請(qǐng)求示例

設(shè)置指定云服務(wù)器的元數(shù)據(jù)信息。

PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/metadata

{
    "metadata": {
            "key1": "value1",
            "key2": "value2"
    }
}

響應(yīng)示例

{
    "metadata": {
            "key1": "value1",
            "key2": "value2"
    }
}

返回值

請(qǐng)參考通用請(qǐng)求返回值