更新时间：2025-11-07 GMT+08:00
分配专属主机
功能介绍
分配一台或多台专属主机，需要设置实例规格、所属AZ、数量等参数。
约束条件
可分配的专属主机数量依赖于租户的专属主机配额。
调试
您可以在API Explorer中调试该接口。
请求消息
|
参数 |
位置 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|---|
|
name |
body |
String |
是 |
专属主机名称。 |
|
auto_placement |
body |
String |
否 |
在创建云服务器时（未指定专属主机ID），是否允许云服务器自动分配在一台可用的专属主机上。 取值范围：“on”或“off”。 默认值：“on”。 |
|
availability_zone |
body |
String |
是 |
专属主机所属AZ。 |
|
host_type |
body |
String |
是 |
专属主机类型。 支持的专属主机类型请参见规格族概述。 |
|
quantity |
body |
Integer |
是 |
待分配的专属主机数量。 |
|
tags |
body |
Array of objects |
否 |
专属主机标签列表。 详情见表3。 |
响应消息
|
参数 |
位置 |
参数类型 |
描述 |
|---|---|---|---|
|
dedicated_host_ids |
body |
Array of strings |
已分配的专属主机ID数组。租户可以在这些专属主机上创建云服务器。 |
请求示例
分配专属主机，分配的可用区为az1，专属主机名称为General Computing server1，类型为s3，数量为2台。
POST https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts
{
"availability_zone": "dc1.az1",
"name": "General Computing server1",
"auto_placement": "off",
"host_type": "c4",
"quantity": 2,
"tags": [
{
"key": "key1",
"value": "value1"
}
]
}
响应示例
{
"dedicated_host_ids": ["xxxxxxx1","xxxxxxx2"]
}
父主题： API
