華為云計(jì)算 云知識(shí) 更新專屬主機(jī)屬性UpdateDedicatedHost
更新專屬主機(jī)屬性UpdateDedicatedHost

 

功能介紹

該接口用于變更 專屬主機(jī) 的“auto_placement”和“name”屬性。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

PUT /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}

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

表1 參數(shù)說明

參數(shù)

參數(shù)類型

是否必選

描述

project_id

String

項(xiàng)目ID。

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

dedicated_host_id

String

專屬主機(jī)ID。

可以從專屬主機(jī)控制臺(tái)查詢,或者通過調(diào)用查詢專屬主機(jī)列表API獲取。

請(qǐng)求消息

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

參數(shù)

是否必選

參數(shù)類型

描述

dedicated_host

Object

專屬主機(jī),詳情請(qǐng)參見表3 dedicated_host字段數(shù)據(jù)結(jié)構(gòu)說明。

表3 dedicated_host字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

位置

參數(shù)類型

是否必選

描述

auto_placement

in

String

在創(chuàng)建 云服務(wù)器 時(shí)(未指定專屬主機(jī)ID),是否允許云服務(wù)器自動(dòng)分配在一臺(tái)可用的專屬主機(jī)上。

取值范圍:“on”或“off”。

name

in

String

專屬主機(jī)名稱。

響應(yīng)消息

請(qǐng)求示例

更新專屬主機(jī)屬性,在創(chuàng)建云服務(wù)器時(shí),不允許云服務(wù)器自動(dòng)分配在一臺(tái)可用的專屬主機(jī)上;將專屬主機(jī)名稱更新為DeH_vm3。
PUT https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/74259164-e63a-4ad9-9c77-a1bd2c9aa187
{
    "dedicated_host": {
        "auto_placement": "off",
        "name": "DeH_vm3"
    }
}

響應(yīng)示例

Http Response Code: 204

返回值

請(qǐng)參見狀態(tài)碼。