分配专属主机CreateDedicatedHost
接口说明
分配一台或多台 专属主机 ,需要设置实例规格、所属AZ、数量等参数。
约束说明
可分配的专属主机数量依赖于租户的专属主机配额。
URL
POST https://deh.cn-north-1.myhuaweicloud.com/v1.0/{project_id}/dedicated-hosts
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
project_id
|
string | path | 是 |
项目ID。 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
name
|
string | 是 |
专属主机名称。 |
|
auto_placement
|
string | 否 |
在创建 云服务器 时(未指定专属主机ID),是否允许 云服务 器自动分配在一台可用的专属主机上。 取值范围:“on”或“off”。 默认值:“on”。 |
|
availability_zone
|
string | 是 |
专属主机所属AZ。 |
|
host_type
|
string | 是 |
专属主机类型。 |
|
quantity
|
integer | 是 |
待分配的专属主机数量。 |
|
tags
|
Array of ResourceTag objects | 否 |
专属主机标签列表。 |
返回参数
返回码: 201
Created 请求成功并且服务器创建了新的资源。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
dedicated_host_ids
|
Array of strings | 是 |
已分配的专属主机ID数组。租户可以在这些专属主机上创建云服务器。 |
返回码: 400
Bad Request 服务器未能处理请求。
返回码: 401
Unauthorized 被请求的页面需要用户名和密码。
返回码: 403
Forbidden 对被请求页面的访问被禁止。
返回码: 404
Not Found 服务器无法找到被请求的页面。
返回码: 500
Internal Server Error 请求未完成,服务异常。
请求示例
示例 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 请求成功并且服务器创建了新的资源。
示例 1
{
"dedicated_host_ids": [
"e02856e1-4cc6-471c-8c0e-be29035342e0",
"bc26dc9e-3473-48ba-aced-a8533d7938c6"
]
}
"dedicated_host_ids": [
"e02856e1-4cc6-471c-8c0e-be29035342e0",
"bc26dc9e-3473-48ba-aced-a8533d7938c6"
]
}
SDK
点击 专属主机 (DeH) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明。
