# 示例1：创建裸金属服务器 #### 操作场景 对于关键类应用或性能要求较高的业务（如大数据集群、企业中间件系统），并且要求安全可靠的运行环境，建议您使用裸金属服务器进行部署。 下面介绍如何调用[创建裸金属服务器](https://support.huaweicloud.com/api-bms/bms_api_0606.html)API创建裸金属服务器，API的调用方法请参见[如何调用API](https://support.huaweicloud.com/api-bms/bms_api_0300.html)。 ![](https://support.huaweicloud.com/api-bms/public_sys-resources/note_3.0-zh-cn.png) 目前仅支持创建包年/包月裸金属服务器。 #### 前提条件 - 您需要规划裸金属服务器所在的区域信息，并根据区域确定调用API的Endpoint，详细信息请参见[终端节点](https://support.huaweicloud.com/api-bms/bms_api_0101.html#bms_api_0101__section322912218471)。 - 裸金属服务器的启动源分为本地盘和云硬盘，对应的裸金属服务器为本地盘裸金属服务器，和快速发放裸金属服务器。有两种方式查看启动源是本地盘还是云硬盘： - 在[裸金属服务器控制台](https://console.huaweicloud.com/ecm/?locale=zh-cn#/bms/createBMS?quickDeploy=true)选择某一规格后，如果"磁盘"配置项中出现"系统盘"参数，表示该规格的启动盘为云硬盘。反之为本地盘。 - 调用[查询规格详情和规格扩展信息列表 - ListBaremetalFlavorDetailExtends](https://support.huaweicloud.com/api-bms/bms_api_0619.html)API，在响应参数中查找"baremetal:extBootType"取值，"LocalDisk"表示启动源为本地盘，"Volume"表示启动源为云硬盘。 #### 创建本地盘裸金属服务器 如下示例是创建本地盘裸金属服务器最简单的配置。 ``` { "server": { "availability_zone": "cn-north-4a", "name": "bms-test01", "imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94", "flavorRef": "physical.s3.large", "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb", "nics": [ { "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616" } ], "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "cn-north-4" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81" }, "key_name": "$key_name" } } ``` - availability_zone：服务所在区域的可用区，您可以在[地区和终端节点](https://developer.huaweicloud.com/endpoint)查询。例如，"cn-north-4a"表示"华北-北京四"的"可用区1"。 - name：裸金属服务器的名称，由您自定义，例如取名为"bms-test01"。 - imageRef：镜像ID，即创建裸金属服务器使用哪个镜像（操作系统）。镜像ID可以在[镜像服务控制台](https://console.huaweicloud.com/ecm/?locale=zh-cn#/ims/manager/imageList/publicImage)查询。 - flavorRef：裸金属服务器使用的规格ID，格式为physical.x.x。规格ID可以从[裸金属服务器控制台](https://console.huaweicloud.com/ecm/?locale=zh-cn#/bms/createBMS?quickDeploy=true)获取，并参考[前提条件]判断规格的启动源，此处选择启动源为本地盘的规格，例如"physical.s3.large"。 - vpcid：裸金属服务器所在VPC（虚拟私有云）的ID，您可以在[虚拟私有云控制台](https://console.huaweicloud.com/vpc/?locale=zh-cn#/vpc/vpcmanager/vpcs)查询，也可以通过[查询VPC列表](https://support.huaweicloud.com/api-vpc/vpc_api01_0003.html)API获取。 - nics.subnet_id：VPC内子网的网络ID，您可以在[虚拟私有云控制台](https://console.huaweicloud.com/vpc/?locale=zh-cn#/vpc/vpcmanager/vpcs)查询，也可以通过[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)API获取。 - extendparam："chargingMode"表示计费模式，"prePaid"为预付费，即包年/包月；"periodType"表示订购周期类型，"month"表示按月；"periodNum"表示订购周期数，本例中的"1"表示一个月；"isAutoRenew"表示是否自动续订；"isAutoPay"表示下单订购后，是否自动从客户的账户中支付，而不需要客户手动去支付；"regionID"表示服务所在的区域ID，您可以在[地区和终端节点](https://developer.huaweicloud.com/endpoint)查询。 - metadata.op_svc_userid：用户ID，您可以在[我的凭证](https://console.huaweicloud.com/iam/?locale=zh-cn#/myCredential)查询。 - key_name：密钥对名称。如果使用SSH密钥方式登录裸金属服务器，需要指定已有密钥的名称。您可以在[密钥对控制台](https://console.huaweicloud.com/ecm/?locale=zh-cn#/keypairs/manager/keypairsList)查询。 #### 创建快速发放裸金属服务器 如下示例是创建快速发放裸金属服务器最简单的配置。 ``` { "server": { "availability_zone": "cn-north-4a", "name": "bms-test02", "imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94", "flavorRef": "physical.h2.large", "root_volume": { "volumetype": "SAS", "size": 150 }, "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb", "nics": [ { "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616" } ], "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "cn-north-4" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81" }, "key_name": "$key_name" } } ``` 相比创建本地盘裸金属服务器，此场景的不同之处是选择启动源为云硬盘的规格，以及设置系统盘参数。 - root_volume.volumetype：系统盘的类型，"SAS"表示"高IO"，您还可以指定其他类型，具体请参见[创建裸金属服务器](https://support.huaweicloud.com/api-bms/bms_api_0606.html)中的参数解释。 - root_volume.size：系统盘大小，容量单位为GB，输入大小范围为\[40,1024\]。系统盘大小取值应不小于镜像中系统盘的最小值（min_disk属性），您可以通过[查询镜像列表](https://support.huaweicloud.com/api-ims/ims_03_0602.html)API查询镜像的min_disk参数值。 #### 创建带数据盘的裸金属服务器 您还可以为裸金属服务器配置数据盘，只需在请求消息体中增加data_volumes字段即可，示例如下： ``` { "server": { "availability_zone": "cn-north-4a", "name": "bms-test03", "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" } ], "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "cn-north-4" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81" }, "key_name": "$key_name" } } ``` - data_volumes.volumetype：数据盘的类型，"SAS"表示"高IO"。 - data_volumes.size：数据盘大小，容量单位为GB，输入大小范围为\[10,32768\]。 - data_volumes.shareable：是否为共享磁盘。"true"为共享盘，"false"为普通云硬盘。 #### 创建带弹性公网IP的裸金属服务器 您还可以为裸金属服务器配置弹性公网IP，只需在请求消息体中增加publicip字段即可，创建裸金属服务器的时候会同时创建一个弹性公网IP，且弹性公网IP与裸金属服务器绑定在一起。示例如下： ``` { "server": { "availability_zone": "cn-north-4a", "name": "bms-test04", "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" } ], "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "cn-north-4" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81" }, "publicip": { "eip": { "iptype": "5_bgp", "bandwidth": { "chargemode": "bandwidth", "name": "bms-test04-bandwidth", "size": 1, "sharetype": "PER" }, "extendparam": [ "chargingMode": "prePaid" ] } }, "key_name": "$key_name" } } ``` - eip.iptype：弹性公网IP地址类型，"5_bgp"表示全动态BGP。 - bandwidth.chargemode：带宽的计费类型，取值包括"traffic"（按流量计费）和"bandwidth"（按带宽计费）。 - bandwidth.name：带宽名称。 - bandwidth.size：带宽大小，单位为Mbit/s，输入大小范围为\[1,2000\]。 - bandwidth.sharetype：带宽的共享类型，"PER"表示独享。 - extendparam.chargingMode：弹性公网IP的计费模式，"prePaid"表示预付费，即包年包月。