華為云計(jì)算 云知識(shí) 分配專屬主機(jī)CreateDedicatedHost
分配專屬主機(jī)CreateDedicatedHost

 

接口說明

分配一臺(tái)或多臺(tái) 專屬主機(jī) ,需要設(shè)置實(shí)例規(guī)格、所屬AZ、數(shù)量等參數(shù)。

約束說明

可分配的專屬主機(jī)數(shù)量依賴于租戶的專屬主機(jī)配額。

URL
POST  https://deh.cn-north-1.myhuaweicloud.com/v1.0/{project_id}/dedicated-hosts 
請(qǐng)求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token。

通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。

project_id
 
string path

項(xiàng)目ID。

Body參數(shù)
名稱 類型 必選 描述
name
 
string

專屬主機(jī)名稱。

auto_placement
 
string

在創(chuàng)建 云服務(wù)器 時(shí)(未指定專屬主機(jī)ID),是否允許云服務(wù)器自動(dòng)分配在一臺(tái)可用的專屬主機(jī)上。 取值范圍:“on”或“off”。 默認(rèn)值:“on”。

availability_zone
 
string

專屬主機(jī)所屬AZ。

host_type
 
string

專屬主機(jī)類型。

quantity
 
integer

待分配的專屬主機(jī)數(shù)量。

tags
 
Array of ResourceTag objects

專屬主機(jī)標(biāo)簽列表。

參數(shù):
tags
名稱 類型 必選 描述
key
 
string

鍵。 長(zhǎng)度不超過36個(gè)Unicode字符。 不能為空。 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”。

value
 
string

值。 長(zhǎng)度不超過43個(gè)Unicode字符。 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”。

返回參數(shù)
返回碼: 201

Created 請(qǐng)求成功并且服務(wù)器創(chuàng)建了新的資源。

名稱 類型 必選 描述
dedicated_host_ids
 
Array of strings

已分配的專屬主機(jī)ID數(shù)組。租戶可以在這些專屬主機(jī)上創(chuàng)建云服務(wù)器。

返回碼: 400

Bad Request 服務(wù)器未能處理請(qǐng)求。

返回碼: 401

Unauthorized 被請(qǐng)求的頁(yè)面需要用戶名和密碼。

返回碼: 403

Forbidden 對(duì)被請(qǐng)求頁(yè)面的訪問被禁止。

返回碼: 404

Not Found 服務(wù)器無法找到被請(qǐng)求的頁(yè)面。

返回碼: 500

Internal Server Error 請(qǐng)求未完成,服務(wù)異常。

請(qǐng)求示例
示例 1
 
"POST /v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts"
 
{ "availability_zone": "dc1.az1", "name": " high performance servers1", "auto_placement": "off", "host_type": "h1", "quantity": 2, "tags": [ { "key": "key1", "value": "value1" } ] }
返回示例
返回碼:201

Created 請(qǐng)求成功并且服務(wù)器創(chuàng)建了新的資源。

示例 1
 
{
"dedicated_host_ids": [
"e02856e1-4cc6-471c-8c0e-be29035342e0",
"bc26dc9e-3473-48ba-aced-a8533d7938c6"
]
}
SDK
點(diǎn)擊 專屬主機(jī) (DeH) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語言類型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說明。