更新时间:2024-02-29 GMT+08:00

分配专属主机

功能介绍

分配一台或多台专属主机,需要设置实例规格、所属AZ、数量等参数。

约束条件

可分配的专属主机数量依赖于租户的专属主机配额。

URI

POST /v1.0/{project_id}/dedicated-hosts

参数说明请参见表1

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

项目ID。

获取方式请参见获取项目ID

请求消息

表2 请求参数

参数

位置

参数类型

是否必选

描述

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

表3 tag字段数据结构说明

参数

参数类型

是否必选

描述

key

String

键。

  • 长度不超过36个Unicode字符。
  • 不能为空。
  • 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”。

value

String

值。

  • 长度不超过43个Unicode字符。
  • 不能包含以下ASCII非打印字符:“=”,“*”,“<”,“>”,“\”,“|”,“/”,“,”。

响应消息

表4 响应参数

参数

位置

参数类型

描述

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-Purpose server1",
     "auto_placement": "off",
     "host_type": "s3",
     "quantity": 2,
     "tags": [
         {
             "key": "key1",
             "value": "value1"
         }
     ] 
}

响应示例

{
    "dedicated_host_ids": ["xxxxxxx1","xxxxxxx2"]
}

返回值

表5 返回值-错误码说明

错误码

说明

403 Forbidden

  1. 配额不足。
  2. 不支持该规格。

404 FlavorNotFound

该规格无效。

更多返回值,请参见状态码