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

 

接口說明

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

約束說明

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

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

用戶Token。

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

project_id
 
string path

項目ID。

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

專屬主機(jī)名稱。

auto_placement
 
string

在創(chuàng)建 云服務(wù)器 時(未指定專屬主機(jī)ID),是否允許云服務(wù)器自動分配在一臺可用的專屬主機(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

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

value
 
string

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

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

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

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

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

返回碼: 400

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

返回碼: 401

Unauthorized 被請求的頁面需要用戶名和密碼。

返回碼: 403

Forbidden 對被請求頁面的訪問被禁止。

返回碼: 404

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

返回碼: 500

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

請求示例
示例 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 請求成功并且服務(wù)器創(chuàng)建了新的資源。

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