裸金属服务器 BMS-创建裸金属服务器(OpenStack原生):请求参数

时间:2024-10-22 15:30:18

请求参数

参数

是否必选

参数类型

描述

server

Object

裸金属服务器信息,详情请参见表2

表2 server字段数据结构说明

参数

是否必选

参数类型

描述

imageRef

String

裸金属服务器使用的镜像ID或者镜像资源的URL。

  • 镜像ID示例:3b8d6fef-af77-42ab-b8b7-5a7f0f0af8f2
  • 镜像URL示例:http://glance.openstack.example.com/images/3b8d6fef-af77-42ab-b8b7-5a7f0f0af8f2
说明:
  • 对于部分规格的裸金属服务器,不能支持云服务平台提供的所有公共镜像。具体规格的镜像支持列表,请登录管理控制台,以“创建裸金属服务器”页面系统自动过滤的镜像信息为准,并在 镜像服务 页面查询镜像ID。
  • 如果创建失败,请尝试修改参数配置。

flavorRef

String

裸金属服务器使用的规格ID或URL。

name

String

裸金属服务器名称。长度大于0小于256字节。

metadata

Object

裸金属服务器元数据,key和value的长度均不大于255字节。详情请参见表3

user_data

String

创建裸金属服务器过程中注入用户数据。

支持注入文本、文本文件或gzip文件。注入内容最大长度32KB。注入内容,需要进行base64格式编码。

adminPass

String

裸金属服务器管理员账户初始登录密码。其中,Linux注入无效,Windows管理员账户为Administrator。

密码复杂度要求:

  • 长度为8-26位。
  • 密码至少必须包含大写字母、小写字母、数字和特殊字符(!@$%^-_=+[{}]:,./?)中的三种。
  • 密码不能包含用户名或用户名的逆序。
  • Windows系统密码不能包含用户名或用户名的逆序,不能包含用户名中超过两个连续字符的部分。

注:不输入则会随机生成密码。

特殊字符:!@$%^-_=+[{}]:,./?

security_groups

Array of objects

指定裸金属服务器的安全组,默认为default,指定network参数时有效,不支持指定多个安全组。详情请参见表4

networks

Array of objects

指定裸金属服务器的网卡信息。详情请参见表5

最多只能指定4个网络信息,其中2个为vxlan类型的网络,2个为geneve类型的网络。参数中第一个网络信息必须为vxlan类型的网络,其会作为裸金属服务器的主网卡网络。若用户指定了多组网络参数,需保证各组参数都属于同一虚拟私有云。

key_name

String

扩展属性,指定keypair的名称。

availability_zone

String

裸金属服务器对应可用区信息,不支持指定具体的主机信息。

表3 metadata字段数据结构说明

参数

是否必选

参数类型

描述

用户自定义字段键值对

String

metadata键、值。

键、值长度均不大于255字节。

表4 security_groups字段数据结构说明

参数

是否必选

参数类型

描述

name

String

裸金属服务器对应的安全组名称。

表5 networks字段数据结构说明

参数

是否必选

参数类型

描述

port

String

网络Port UUID。

uuid

String

网络UUID。

fixed_ip

String

指定的IP地址。

support.huaweicloud.com/api-bms/bms_api_0706.html