创建云服务器

功能介绍

创建一台或多台云服务器。

本接口为异步接口，当前创建云服务器请求下发成功后会返回job_id，此时创建云服务器并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUCCESS 时代表云服务器创建成功。

URI

POST /v1/{project_id}/cloudservers

请求消息

请求参数

请求参数如表2所示。

响应消息

异常响应请参考响应（任务类），异常响应要素说明。

请求示例

• 创建一台按需计费云服务器，操作系统为CentOS 7.6 64bit，4U8G，磁盘类型为“SSD”，绑定10M的按带宽计费的弹性公网IP，采用密钥方式登录鉴权。

  POST https://{endpoint}/v1/{project_id}/cloudservers
  
  {
      "server": {
          "availability_zone":"az1-dc1",
          "name": "newserver", 
          "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", 
          "root_volume": {
              "volumetype": "SSD"
          }, 
          "data_volumes": [ 
              {
                  "volumetype": "SSD", 
                  "size": 100,
                  "multiattach": true,
                  "hw:passthrough": true
              }
          ], 
          "flavorRef": "s3.xlarge.2", 
          "vpcid": "0dae26c9-9a70-4392-93f3-87d53115d171", 
          "security_groups": [
              {
                  "id": "507ca48f-814c-4293-8706-300564d54620"
              }
          ], 
          "nics": [
              {
                  "subnet_id": "157ee789-03ea-45b1-a698-76c92660dd83"
              }
          ], 
          "publicip": {
              "eip": {
                  "iptype": "5_bgp",
                  "bandwidth": {
                      "size": 10, 
                      "sharetype": "PER"
                  }
              }
          }, 
          "key_name": "sshkey-123", 
          "count": 1, 
          "server_tags": [
              {
                  "key": "key1",
                  "value": "value1"
              }
          ],
          "metadata": {
                 "op_svc_userid": "8ea65f4099ba412883e2a0da72b96873",
                 "agency_name": "test"
          }
      }
  }

• 使用系统盘加密且自带两个数据盘的整机镜像创建云服务器，对于恢复的两块数据盘，一块按默认属性恢复，另一块更改磁盘属性为“SSD，100GB”；再为创建的云服务器新挂载一个属性为“SSD，50GB”的数据盘。

  POST https://{endpoint}/v1/{project_id}/cloudservers
  
  {
      "server": {
          "availability_zone":"az1-dc1", 
          "name": "wholeImageServer", 
          "imageRef": "ff49b1f1-3e3e-4913-89c6-a026041661e8", 
          "root_volume": {
              "volumetype": "SSD",
              "metadata": {
                   "__system__encrypted": "1",
                   "__system__cmkid": "83cdb52d-9ebf-4469-9cfa-e7b5b80da846"
               }
          }, 
          "data_volumes": [
              {
                  "volumetype": "SSD", 
                  "size": 100,
                  "extendparam":{
                      "snapshotId": "ef020653-9742-4d24-8672-10af42c9702b"
                  }
              }, 
              {
                  "volumetype": "SSD", 
                  "size": 50
              }
          ], 
          "flavorRef": "s2.large.2", 
          "vpcid": "0dae26c9-9a70-4392-93f3-87d53115d171", 
          "security_groups": [
              {
                  "id": "507ca48f-814c-4293-8706-300564d54620"
              }
          ], 
          "nics": [
              {
                  "subnet_id": "157ee789-03ea-45b1-a698-76c92660dd83"
              }
          ],
          "key_name": "sshkey-123"
      }
  }

• 发送预校验请求，检查创建弹性云服务器的请求消息是否填写了必选参数，请求格式是否正确。

  POST https://{endpoint}/v1/{project_id}/cloudservers
  
  {
      "dry_run": true,
      "server": {
          "availability_zone":"az1-dc1",
          "name": "newserver", 
          "imageRef": "1189efbf-d48b-46ad-a823-94b942e2a000", 
          "root_volume": {
              "volumetype": "SSD"
          }, 
          "data_volumes": [
              {                 
                   "volumetype": "SSD",                  
                   "size": 100,                 
                   "multiattach": true,                 
                   "hw:passthrough": true             
              }
          ], 
          "flavorRef": "s3.xlarge.2", 
          "vpcid": "0dae26c9-9a70-4392-93f3-87d53115d171", 
          "security_groups": [
              {
                  "id": "507ca48f-814c-4293-8706-300564d54620"
              }
          ], 
          "nics": [
              {
                  "subnet_id": "157ee789-03ea-45b1-a698-76c92660dd83"
              }
          ], 
          "key_name": "sshkey-123", 
          "count": 1
      }
  }

响应示例

{
    "job_id": "93c82933d6b7827d3016b8771f2070873"
}

或

{
    "error": {
        "code": "request body is illegal.", 
        "message": "Ecs.0005"
    }
}

或

{
    "error": {
        "message": "privateIp [%s] is not in this subnet [%s]",
        "code": "Ecs.0005",
        "details": [
            {
                "code": "Ecs.0039"
            }
        ]
    }
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。