创建一台或多台裸金属服务器。
裸金属服务器的登录鉴权方式包括两种:密钥对、密码。为安全起见,推荐使用密钥对方式。
接口调用方法:使用key_name字段,指定裸金属服务器登录时使用的密钥文件。key_name字段的使用方法请参见表2。
指使用设置初始密码方式作为裸金属服务器的鉴权方式,此时,您可以通过用户名密码方式登录裸金属服务器,Linux操作系统时为root用户的初始密码,Windows操作系统时为Administrator用户的初始密码。
接口调用方法:
此时,对于安装了Cloud-init镜像的Linux裸金属服务器,若指定user_data字段,则该adminPass字段无效;对于安装了Cloudbase-init镜像的Windows裸金属服务器,若指定元数据metadata字段中的admin_pass,则该adminPass字段无效。
公共镜像默认已安装Cloud-init或者Cloudbase-init,私有镜像需要您自行确认是否安装。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
server |
是 |
Object |
裸金属服务器信息。详情请参见表2。 |
参数 |
是否必选 |
参数类型 |
描述 |
||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
imageRef |
是 |
String |
裸金属服务器使用的镜像ID或者镜像资源的URL。ID格式为通用唯一识别码(Universally Unique Identifier,简称UUID)。 镜像ID可以从镜像服务控制台获取,或者参考《镜像服务API参考》的“查询镜像列表”章节查询。 在使用“查询镜像列表”API查询时,可以添加过滤字段“?virtual_env_type=Ironic”来筛选裸金属服务器镜像。 |
||||||||
flavorRef |
是 |
String |
裸金属服务器使用的规格ID,格式为physical.x.x。 规格ID可以从裸金属服务器控制台获取,也可以通过查询裸金属服务器规格信息列表(OpenStack原生)API查询。 说明:
裸金属服务器规格与镜像间的约束关系请参见裸金属服务器类型与支持的操作系统版本。 对于physical.x.x.hba类型的规格,申请的租户只能是DeC租户,且只能挂载DESS卷。 |
||||||||
name |
是 |
String |
裸金属服务器名称。 取值范围:
|
||||||||
metadata |
是 |
Object |
裸金属服务器元数据,key和value的长度均不大于255字节。详情请参见表3。 |
||||||||
user_data |
否 |
String |
创建裸金属服务器过程中待注入的用户数据。支持注入文本、文本文件或gzip文件。 约束:
建议密码复杂度如下:
示例:
其中,$6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig为密文密码,生成方法如下:
说明:
使用Linux镜像并且采用密码登录裸金属服务器时,不支持数据注入。如何注入请参见用户数据注入。 |
||||||||
adminPass |
否 |
String |
如果需要使用密码方式登录裸金属服务器,可使用adminPass字段指定裸金属服务器管理员帐户初始登录密码。其中,Linux管理员帐户为root,Windows管理员帐户为Administrator。 密码复杂度要求:
|
||||||||
key_name |
否 |
String |
扩展属性,指定密钥的名称。如果需要使用SSH密钥方式登录裸金属服务器,请指定已有密钥的名称。 密钥可以通过创建和导入SSH密钥(OpenStack原生)API创建,或者使用查询SSH密钥列表(OpenStack原生)API查询已有的密钥。 约束:
|
||||||||
security_groups |
否 |
Array of objects |
指定裸金属服务器的安全组。详情请参见表4。 |
||||||||
nics |
是 |
Array of objects |
指定裸金属服务器的网卡信息。详情请参见表5。 约束: 一个裸金属服务器最多挂载2个网卡,参数中第一个网卡会作为裸金属服务器的主网卡。若用户指定了多组网卡参数,需保证各组参数都属于同一VPC。 |
||||||||
availability_zone |
是 |
String |
裸金属服务器对应可用区信息,需要指定可用区(AZ)的名称。 请参考地区和终端节点获取。 |
||||||||
vpcid |
是 |
String |
裸金属服务器所属虚拟私有云(VPC),需要指定已有VPC的ID,UUID格式。VPC的ID可以从网络控制台或者参考《虚拟私有云API参考》的“查询VPC”章节获取。 |
||||||||
publicip |
否 |
Object |
配置裸金属服务器的弹性公网IP信息,弹性公网IP有三种配置方式:
详情请参见表6。 |
||||||||
count |
否 |
Integer |
创建裸金属服务器的数量。 约束:
|
||||||||
root_volume |
否 |
Object |
裸金属服务器对应系统盘相关配置。详情请参见表7。 约束: 当规格是快速发放时,该参数必选。查询规格是否为快速发放,参见查询裸金属服务器规格extra_specs参数的详情(OpenStack原生)。 |
||||||||
data_volumes |
否 |
Array of objects |
裸金属服务器对应数据盘相关配置。每一个数据结构代表一个待创建的数据盘。详情请参见表8。 约束: 目前裸金属服务器最多可挂载60块云硬盘(包括系统盘和数据盘)。 |
||||||||
extendparam |
是 |
Object |
创建裸金属服务器的附加信息。详情请参见表9。 |
||||||||
schedulerHints |
否 |
Object |
裸金属服务器的调度信息。当需要在专属云中创建裸金属服务器时,该字段必选。 详情请参见表10。 |
||||||||
server_tags |
否 |
Array of objects |
裸金属服务器的标签。详情请参见表11。 说明:
创建裸金属服务器时,一台裸金属服务器最多可以添加10个标签。其中,__type_baremetal为系统内部标签,因此实际能添加的标签为9个。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
op_svc_userid |
是 |
String |
用户ID(登录管理控制台,进入我的凭证,即可看到“用户ID”)。 |
BYOL |
否 |
String |
是否自带许可,取值“true”或“false”。 |
admin_pass |
否 |
String |
以Windows镜像创建的裸金属服务器Administrator用户的密码,示例:cloud.1234。 密码复杂度要求:
|
agency_name |
否 |
String |
委托的名称。 委托是由租户管理员在统一身份认证服务(Identity and Access Management,IAM)上创建的,可以作为其他租户访问此裸金属服务器的临时凭证。 说明:
委托获取、更新请参考如下步骤:
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
裸金属服务器对应的安全组ID,对创建裸金属服务器中配置的所有网卡生效。
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
subnet_id |
是 |
String |
裸金属服务器网卡所在的子网信息。 需要指定vpcid对应VPC下已创建的子网(subnet)的网络ID(network_id),UUID格式。子网(subnet)的网络ID(network_id)可以从虚拟私有云控制台或者参考《虚拟私有云API参考》的“查询子网列表”章节获取。 |
ip_address |
否 |
String |
裸金属服务器网卡的IP地址,IPv4格式。 约束:
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
创建裸金属服务器分配已有弹性公网IP时,分配的弹性公网IP的ID,UUID格式。弹性公网IP的ID可以从网络控制台或者参考《弹性公网IP API参考》的“查询弹性公网IP列表”章节获取。 约束:
|
eip |
否 |
Object |
配置裸金属服务器自动分配弹性公网IP时,创建弹性公网IP的配置参数。详情请参见表12。 |
输入publicip字段数据结构中的id和eip参数值时,只能选择其中一个输入。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
volumetype |
是 |
String |
裸金属服务器系统盘对应的磁盘类型,需要与系统所提供的磁盘类型相匹配。
|
size |
是 |
Integer |
系统盘大小,容量单位为GB,输入大小范围为[40-1024]。 约束: 系统盘大小取值应不小于镜像中系统盘的最小值(min_disk属性)。 |
cluster_id |
否 |
String |
裸金属服务器系统盘对应的存储池的ID。 说明:
|
cluster_type |
否 |
String |
裸金属服务器系统盘对应的磁盘存储类型。磁盘存储类型枚举值:DSS(专属分布式存储)。 说明:
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
volumetype |
是 |
String |
裸金属服务器数据盘对应的磁盘类型,需要与系统所提供的磁盘类型相匹配。
约束:
说明:
企业存储支持的存储类型说明可以从管理控制台或参考《专属企业存储服务用户指南》的“申请专属企业存储”章节获取。 |
size |
是 |
Integer |
数据盘大小,容量单位为GB,输入大小范围为[10-32768]。 |
shareable |
否 |
Boolean |
是否为共享磁盘。
不指定时默认为false。 |
cluster_id |
否 |
String |
裸金属服务器数据盘对应的存储池ID。 说明:
|
cluster_type |
否 |
String |
裸金属服务器数据盘对应的磁盘存储类型。磁盘存储类型枚举值:DSS(专属分布式存储)。 说明:
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
chargingMode |
否 |
String |
计费模式。取值范围: prePaid:预付费,即包年包月。 默认值是prePaid。 |
regionID |
否 |
String |
裸金属服务器所在区域ID。 请参考地区和终端节点获取。 |
periodType |
否 |
String |
订购周期类型。取值范围:
说明:
chargingMode为prePaid时生效,且为必选值。 |
periodNum |
否 |
Integer |
订购周期数。取值范围:
说明:
chargingMode为prePaid时生效,且为必选值。 |
isAutoRenew |
否 |
String |
是否自动续订。
说明:
chargingMode为prePaid时生效,不指定该参数或者该参数值为空时默认为不自动续订。 |
isAutoPay |
否 |
String |
下单订购后,是否自动从客户的帐户中支付,而不需要客户手动去支付。
说明:
chargingMode为prePaid时生效,不指定该参数或者该参数值为空时默认为客户手动支付。 |
enterprise_project_id |
否 |
String |
企业项目ID。 该字段不传(或传为字符串“0”),则将资源绑定给默认企业项目。 说明:
关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理API参考》。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
dec_baremetal |
否 |
String |
是否在专属云中创建裸金属服务器,参数值为share或dedicate。 约束:
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
key |
是 |
String |
键。
|
value |
是 |
String |
值。
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
iptype |
是 |
String |
弹性公网IP地址类型。 类型枚举值:5_bgp、5_sbgp 详情请参见《弹性公网IP API参考》“申请弹性公网IP”章节的“publicip”字段说明。 |
bandwidth |
是 |
Object |
弹性公网IP带宽。详情请参见表13。 |
extendparam |
是 |
Object |
创建弹性公网IP的附加信息。详情请参见表14。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
否 |
String |
带宽名称。 |
sharetype |
是 |
String |
带宽的共享类型。 共享类型枚举:PER,表示独享;WHOLE,表示共享 |
id |
否 |
String |
共享带宽ID。创建WHOLE类型带宽的弹性公网IP时可以指定之前的共享带宽创建。 共享带宽的使用限制请参见“共享带宽简介”。 说明:
当创建WHOLE类型的带宽时,该字段必选。 |
size |
是 |
Integer |
说明:
|
chargemode |
否 |
String |
带宽的计费类型。 取值为:traffic(按流量计费)、bandwidth(按带宽计费)
说明:
如果sharetype是WHOLE并且id有值,仅支持按带宽计费,该参数会忽略。 |
1 | POST https://{BMS Endpoint}/v1/{project_id}/baremetalservers
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 | {
"server": {
"availability_zone": "az1",
"name": "bms-75c7",
"imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94",
"flavorRef": "physical.s3.large",
"data_volumes": [
{
"volumetype": "SAS",
"size": 10,
"shareable": false
}
],
"vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb",
"nics": [
{
"subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616",
"ip_address": ""
}
],
"count": 1,
"schedulerHints": {
"dec_baremetal": "share"
},
"extendparam": {
"chargingMode": "prePaid",
"periodType": "month",
"periodNum": 1,
"isAutoRenew": "true",
"isAutoPay": "true",
"regionID": "region01"
},
"metadata": {
"op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81",
"BYOL": "false",
"admin_pass": ""
},
"publicip": {
"id": "1b036bce-26b4-465c-acea-99fdbb0573a3"
},
"user_data": "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiR0Y0pZamUkNGhhUHlNZFR4VWVHc2dTMWFmL1NsMm4vbXZzdy5wSFdjbTVBc084OWFhUFhGNXUvVnJ5OXJiYmZZSW45SmZac2k3SlRmd2Z6djJPbTBHRFZUZTd6RDEnIHwgY2hwYXNzd2QgLWU7",
"security_groups": [
{
"id": "993f2916-5bad-4f24-bc3c-db539f1a6d19"
}
]
}
}
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 | {
"server": {
"availability_zone": "az1",
"name": "bms-3b91",
"imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94",
"flavorRef": "physical.o2.large",
"data_volumes": [
{
"volumetype": "SAS",
"size": 10,
"shareable": true
}
],
"vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb",
"nics": [
{
"subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616",
"ip_address": ""
},
{
"subnet_id": "2b8bcf33-33f2-4a63-aa9c-b1e17ff0ed7f",
"ip_address": ""
}
],
"count": 1,
"schedulerHints": {
"dec_baremetal": "share"
},
"extendparam": {
"chargingMode": "prePaid",
"periodType": "month",
"periodNum": 1,
"isAutoRenew": "true",
"isAutoPay": "true",
"regionID": "region01"
},
"metadata": {
"op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81",
"BYOL": "false"
},
"publicip": {
"eip": {
"iptype": "5_bpg",
"bandwidth": {
"chargemode": "",
"name": "bms-3b91-bandwidth",
"size": 1,
"sharetype": "PER"
}
}
},
"security_groups": [
{
"id": "993f2916-5bad-4f24-bc3c-db539f1a6d19"
}
],
"key_name": "KeyPair-zbb29"
}
}
|
Java语言生成user_data示例如下:
1 2 3 | String userData_org = "#!/bin/bash \r\n echo 'root:P@ssWr0d123' | chpasswd ;";
byte[] userData_byte = userData_org.getBytes();
String userData = new BASE64Encoder().encode(userData_byte);
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 | {
"server": {
"availability_zone": "az1",
"name": "bms-6a1e",
"imageRef": "fd04041a-5f35-45ae-a27c-bf30f921c6b5",
"flavorRef": "physical.s3.large",
"data_volumes": [],
"vpcid": "0adc2847-c160-4263-be1f-e03d36e93e32",
"nics": [
{
"subnet_id": "4f1cf6cc-4cc3-41d3-8192-625293dccce0",
"ip_address": ""
}
],
"count": 1,
"schedulerHints": {
"dec_baremetal": "share"
},
"extendparam": {
"chargingMode": "prePaid",
"periodType": "month",
"periodNum": 1,
"isAutoRenew": "true",
"isAutoPay": "true",
"regionID": "region1"
},
"metadata": {
"op_svc_userid": "8a74baed155b47e8b59fbca853d6cb48",
"BYOL": "false"
},
"publicip": {
"id": "db9c4f39-fabd-4cc2-8685-82e7715d099f"
},
"user_data": "cWF6PTEyMw==",
"security_groups": [
{
"id": "33cf5e40-0b65-4e03-867d-4c67947c49be"
}
],
"key_name": "KeyPair-Maoz"
}
}
|
{ "server": { "name": "bms-roce-test", "availability_zone": "cn-arm", "flavorRef": "physical.kat1.8xlarge.ondemand", "imageRef": "6a299c39-f558-4912-b982-fc993a6ed5fd", "vpcid": "844ecdc5-8c81-4caa-a3f4-7de41c7ee96e", "nics": [ { "subnet_id": "18cea8f7-1892-42b0-ab4e-ea4287514c2e" }, { "subnet_id": "270dc482-a624-4cef-b90d-42d272917bea" } ], "security_groups": [ { "id": "bc2ebcf9-29c9-4679-bdc4-316e638c059d" } ], "extendparam": { "chargingMode": 0, "regionID": "cn-xian-3" }, "metadata": { "op_svc_userid": "e81efc34179c4186bd2bd4f9a2378cac", "BYOL": "false" }, "server_tags": [], "user_data": "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRzTFRVRzMkajN6VXVTREw4cnFMam1jZTJhQVpQZ3JIYUp0ejk0WmdmaUhtYXljRUdsS1BXOS9EVjlpTjR4cFRpTE1KYnVPTjVsdG1uSHF5bTZNc2Q4T0F5dHRkTTAnIHwgY2hwYXNzd2QgLWU7", "count": 1 } }
{ "server": { "name": "bms-75c7", "availability_zone": "az1", "flavorRef": "physical.kat1.8xlarge.ondemand", "imageRef": "6a299c39-f558-4912-b982-fc993a6ed5fd", "vpcid": "844ecdc5-8c81-4caa-a3f4-7de41c7ee96e", "root_volume": { "size": 40, "volumetype": "SSD" }, "nics": [ { "subnet_id": "18cea8f7-1892-42b0-ab4e-ea4287514c2e" }, { "subnet_id": "270dc482-a624-4cef-b90d-42d272917bea" } ], "security_groups": [ { "id": "bc2ebcf9-29c9-4679-bdc4-316e638c059d" } ], "extendparam": { "chargingMode": 0, "regionID": "cn-xian-3" }, "metadata": { "op_svc_userid": "e81efc34179c4186bd2bd4f9a2378cac", "BYOL": "false" }, "server_tags": [], "user_data": "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRzTFRVRzMkajN6VXVTREw4cnFMam1jZTJhQVpQZ3JIYUp0ejk0WmdmaUhtYXljRUdsS1BXOS9EVjlpTjR4cFRpTE1KYnVPTjVsdG1uSHF5bTZNc2Q4T0F5dHRkTTAnIHwgY2hwYXNzd2QgLWU7", "count": 1 } }
如果创建包年包月计费的裸金属服务器,请参考订单Id的响应。
请参考错误码。
本文转载自微信公众号「脑子进煎鱼了」,作者陈煎鱼 。转载本文请联系脑子进煎鱼...
对于广大的 Flink 开发者同学来说, 什么内容是最期待的? 什么信息又是最有用的...
hk 域名 哪里注册? .hk域名 在国内是可以注册的,只要提供了.hk 域名注册 服务...
随着云计算、物联网、移动互联网等互联网技术的快速发展,人们对于网络技术的依...
作者 | 黄玉奇 来源 | 阿里巴巴云原生公众号 日前,在由全球分布式云联盟主办的...
2020年,AWS的年收入规模已经超过450亿美元,营收增速和运营利润率超过30%。IDC...
怎么升级 虚拟主机 ?当网站运营到一定阶段,虚拟主机配置跟不上网站发展,这时...
只有 域名 能备案吗?不能的,备案是需要国内空间的, 虚拟主机 或者服务器的都...
深入浅出AbstractQueuedSynchronizer 在Java多线程编程中,重入锁(ReentrantLock...
FFmpeg备忘清单 ffmpeg命令行工具的有用命令列表。 下载FFmpeg:https://www.ffm...