创建云服务器

功能介绍

创建一台弹性云服务器。

URI

POST /v2.1/{project_id}/servers

创建弹性云服务器接口别名：/v2/{project_id}/os-volumes_boot，该调用方式仅在OpenStack Client中使用，用户不推荐使用。

接口约束

1. 该接口为原生接口，不支持整机镜像创建弹性云服务器功能。如需使用整机镜像创建弹性云服务器，请使用创建云服务器。
2. 使用该接口创建的云服务器，不支持在创建过程中绑定弹性公网IP，推荐使用创建云服务器创建云服务器并绑定弹性公网IP。
3. 网络的三个参数（port、uuid和fixed_ip）中，port优先级最高；指定fixed_ip时必须指明uuid。
4. 注入文件失败，将导致创建弹性云服务器失败。
5. 使用镜像创建弹性云服务器时，存在下面约束：
   1. 不支持指定Host创建弹性云服务器。
   2. 租户如果对弹性云服务器中的卷进行了备份，则需要租户自行删除该卷所对应的快照等数据后，才能删除卷。
   3. 调整镜像创建的弹性云服务器规格时，不支持resource_type不同的flavor之间的规格调整。
6. 云服务平台提供的原生接口/v2/{project_id}/servers 和 /v2.1/{project_id}/servers 是基于社区版OpenStack原生接口加固而成的，兼容社区版OpenStack原生接口。
   较之社区版的OpenStack原生接口，在使用指定镜像的方式创建弹性云服务器时存在如下差异：

   • 社区OpenStack原生接口：默认使用服务器本地磁盘创建弹性云服务器。
   • 云服务平台提供的原生接口：为了保障可靠性，使用共享存储作为系统盘创建弹性云服务器。
   该差异的具体表现为，当您使用提供的原生接口创建云服务器时：

   1. 可以查询到云服务器挂载的系统盘信息。
   2. 云服务器的系统盘会占用云硬盘的配额。
   3. 不支持使用image过滤查询指定镜像方式创建的弹性云服务器。
7. 指定卷创建弹性云服务器场景下，指定的卷与创建的弹性云服务器必须处于相同的AZ（availability_zone）。
8. 用户创建弹性云服务器时在block_device_mapping_v2设置的device_name字段不会生效，系统会默认生成一个device_name。
9. 请勿使用“provider:network_type”为“geneve”的网络来创建弹性云服务器。
   

   “provider:network_type”为“geneve”时，表示裸金属服务器使用的内部高速网络。

10. 如果使用密钥方式远程登录云服务器，请使用key_name参数。如果使用密码方式远程登录云服务器，可使用adminPass参数；对于Linux云服务器，还可使用user_data进行注入，对于Windows云服务器，还可通过元数据admin_pass进行注入。
11. 如果用于创建弹性云服务器的镜像使用的是原生接口，则在创建云服务器时，需注意将指定的AZ、系统盘大小和类型与创建镜像时所使用的云服务器的AZ、系统盘大小和类型保持一致，否则弹性云服务器将无法创建成功。

请求消息

请求参数如表2所示。

响应消息

响应参数如表9所示。

请求示例

• 通过block_device_mapping_v2扩展属性使用镜像创建一台云服务器，采用密钥方式登录鉴权。

  POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers
  
  { 
      "server": { 
          "flavorRef": "s3.xlarge.2", 
          "name": "wjvm48", 
          "metadata": { 
              "name": "name_xx1", 
              "id": "id_xxxx1" 
          }, 
          "block_device_mapping_v2": [{ 
              "source_type": "image", 
              "destination_type": "volume", 
              "uuid": "b023fe17-11db-4efb-b800-78882a0e394b", 
              "delete_on_termination": "False", 
              "boot_index": "0",
              "volume_type": "SAS",
              "volume_size": "40"
          }], 
          "security_groups": [{ 
              "name": "name_xx5_sg" 
          }], 
          "networks": [{ 
              "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c", 
              "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f", 
              "fixed_ip": "10.20.30.137" 
          }], 
          "key_name": "test", 
          "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", 
          "availability_zone":"az1-dc1"
      } 
  }

• 通过block_device_mapping_v2扩展属性使用快照创建一台云服务器，其中，boot_index为0，且该快照对应的云硬盘必须为系统盘。

  POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers
  
  {
      "server":{
          "name":"wjvm48",
          "availability_zone":"az1-dc1",
          "block_device_mapping_v2": [
              {
                  "source_type":"snapshot",
                  "boot_index":"0",
                  "uuid":"df51997d-ee35-4fb3-a372-e2ac933a6565", // snapshot id，创建snapshot接口会返回id
                  "destination_type":"volume"
              }
          ],
          "flavorRef":"s3.xlarge.2",
          "max_count":1,
          "min_count":1,
          "networks": [
              {
                  "uuid":"79a68cef-0936-4e21-b1f4-b800ecb70246"
              }
          ] 
      } 
  }

• 通过block_device_mapping_v2使用卷创建一台弹性云服务器。

  POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers
  
  { 
      "server": { 
          "flavorRef": "s3.xlarge.2", 
          "name": "wjvm48", 
          "metadata": { 
              "name": "name_xx1", 
              "id": "id_xxxx1" 
          }, 
          "block_device_mapping_v2": [{ 
              "source_type": "volume", 
              "destination_type": "volume", 
              "uuid": "bd7e4f86-b004-4745-bea2-a55b1085f107", 
              "delete_on_termination": "False", 
              "boot_index": "0", 
              "volume_type": "dsware",
              "volume_size": "40"
          }], 
          "security_groups": [{ 
              "name": "name_xx5_sg" 
          }], 
          "networks": [{ 
              "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c", 
              "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f", 
              "fixed_ip": "10.20.30.137" 
          }], 
          "key_name": "test", 
          "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", 
          "availability_zone":"az1-dc1"
      } 
  }

• 使用imageRef创建一台弹性云服务器，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。

  POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers
  
  { 
      "server": { 
          "flavorRef": "s3.xlarge.2", 
          "name": "wjvm48", 
          "metadata": { 
              "name": "name_xx1", 
              "id": "id_xxxx1" 
          }, 
          "adminPass": "$ADMIN_PASS",
          "imageRef": "6b344c54-d606-4e1a-a99e-a7d0250c3d14",
          "security_groups": [{ 
              "name": "name_xx5_sg" 
          }], 
          "networks": [{ 
              "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c",
              "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f",
              "fixed_ip": "10.20.30.137" 
          }], 
          "key_name": "test", 
          "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", 
          "availability_zone":"az1-dc1"
      } 
  }

• 批量创建弹性云服务器，最小数量为2，最大数量为3。

  POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers
  
  {
      "server": {
          "availability_zone":"az1.dc1",
          "name": "test",
          "imageRef": "10ff4f01-35b6-4209-8397-359cb4475fa0",
          "flavorRef": "s3.xlarge.2",
          "return_reservation_id": "true",
          "networks": [
              {
                  "uuid": "51bead38-d1a3-4d08-be20-0970c24b7cab"
              }
          ],
          "min_count": "2",
          "max_count": "3"
      }
  }

响应示例

创建弹性云服务器：

{
    "server": {
        "security_groups": [
            {
                "name": "name_xx5_sg"
            }
        ],
        "OS-DCF:diskConfig": " MANUAL",
        "id": "567c1557-0eca-422c-bfce-149d6b8f1bb8",
        "links": [
            {
                "href": "http://xxx/v2/dc4059e8e7994f2498b514ca04cdaf44/servers/567c1557-0eca-422c-bfce-149d6b8f1bb8",
                "rel": "self"
            },
            {
                "href": "http://xxx/dc4059e8e7994f2498b514ca04cdaf44/servers/567c1557-0eca-422c-bfce-149d6b8f1bb8",
                "rel": "bookmark"
            }
        ],
        "adminPass": "*********"
    }
}

批量创建弹性云服务器：

{
    "reservation_id": "r-3fhpjulh"
}

返回值

请参考通用请求返回值。