示例1：创建裸金属服务器

操作场景

对于关键类应用或性能要求较高的业务（如大数据集群、企业中间件系统），并且要求安全可靠的运行环境，建议您使用裸金属服务器进行部署。

下面介绍如何调用创建裸金属服务器API创建裸金属服务器，API的调用方法请参见如何调用API。

目前仅支持创建包年/包月裸金属服务器。

前提条件

您需要规划裸金属服务器所在的区域信息，并根据区域确定调用API的Endpoint，详细信息请参见终端节点。
裸金属服务器的启动源分为本地盘和云硬盘，对应的裸金属服务器为本地盘裸金属服务器，和快速发放裸金属服务器。有两种方式查看启动源是本地盘还是云硬盘：
- 在裸金属服务器控制台选择某一规格后，如果“磁盘”配置项中出现“系统盘”参数，表示该规格的启动盘为云硬盘。反之为本地盘。
- 调用查询规格详情和规格扩展信息列表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：服务所在区域的可用区，您可以在地区和终端节点查询。例如，“cn-north-4a”表示“华北-北京四”的“可用区1”。
name：裸金属服务器的名称，由您自定义，例如取名为“bms-test01”。
imageRef：镜像ID，即创建裸金属服务器使用哪个镜像（操作系统）。镜像ID可以在镜像服务控制台查询。
flavorRef：裸金属服务器使用的规格ID，格式为physical.x.x。规格ID可以从裸金属服务器控制台获取，并参考前提条件判断规格的启动源，此处选择启动源为本地盘的规格，例如“physical.s3.large”。
vpcid：裸金属服务器所在VPC（虚拟私有云）的ID，您可以在虚拟私有云控制台查询，也可以通过查询VPC列表API获取。
nics.subnet_id：VPC内子网的网络ID，您可以在虚拟私有云控制台查询，也可以通过查询子网列表API获取。
extendparam：“chargingMode”表示计费模式，“prePaid”为预付费，即包年/包月；“periodType”表示订购周期类型，“month”表示按月；“periodNum”表示订购周期数，本例中的“1”表示一个月；“isAutoRenew”表示是否自动续订；“isAutoPay”表示下单订购后，是否自动从客户的账户中支付，而不需要客户手动去支付；“regionID”表示服务所在的区域ID，您可以在地区和终端节点查询。
metadata.op_svc_userid：用户ID，您可以在我的凭证查询。
key_name：密钥对名称。如果使用SSH密钥方式登录裸金属服务器，需要指定已有密钥的名称。您可以在密钥对控制台查询。

创建快速发放裸金属服务器

如下示例是创建快速发放裸金属服务器最简单的配置。

    
     
       
       
         {
    "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"
    }
}

        

      

    
   

相比创建本地盘裸金属服务器，此场景的不同之处是选择启动源为云硬盘的规格，以及设置系统盘参数。

volumetype：系统盘的类型，“SAS”表示“高IO”，您还可以指定其他类型，具体请参见创建裸金属服务器中的参数解释。
size：系统盘大小，容量单位为GB，输入大小范围为[40,1024]。系统盘大小取值应不小于镜像中系统盘的最小值（min_disk属性），您可以通过查询镜像列表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"
    }
}

        

      

    
   

volumetype：数据盘的类型，“SAS”表示“高IO”。
size：数据盘大小，容量单位为GB，输入大小范围为[10,32768]。
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"
    }
}

        

      

    
   

iptype：弹性公网IP地址类型，“5_bgp”表示全动态BGP。
chargemode：带宽的计费类型，取值包括“traffic”（按流量计费）和“bandwidth”（按带宽计费）。
name：带宽名称。
size：带宽大小，单位为Mbit/s，输入大小范围为[1,2000]。
sharetype：带宽的共享类型，“PER”表示独享。
extendparam.chargingMode：弹性公网IP的计费模式，“prePaid”表示预付费，即包年包月。

父主题： 应用示例

上一篇：应用示例

下一篇：示例2：查询裸金属服务器

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消