场景描述
本章节指导用户通过API创建云服务器。API的调用方法请参见如何调用API。
创建云服务器时,支持通过卷和镜像两种方式进行创建。本节以指定镜像的方式为例,介绍如何创建云服务器。

约束限制
该接口创建出来的是按需付费的实例。
涉及接口
创建云服务器时,需要进行规格查询、可用区查询、云硬盘创建等操作,涉及的接口如下:
查询可用区列表:确定待创建云服务器所在的可用区。
查询云服务器规格详情列表:确定待创建云服务器的规格。
查询镜像列表详情:确定待创建云服务器使用的镜像。
查询网络列表:确定云服务器的网络信息。
创建和导入SSH密钥:设置密钥对登录方式。
创建云服务器:创建密钥对登录鉴权的云服务器。
查询云服务器详情:确认云服务器创建成功。
操作步骤
确定待创建云服务器所在的可用区。
查询可用区。
接口相关信息
URI格式:GET /v2.1/{project_id}/os-availability-zone
详情请参见查询可用区列表。
请求示例
GET https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/os-availability-zone
{endpoint}信息请从地区和终端节点获取。
响应示例
{
"availabilityZoneInfo": [
{
"hosts": null,
"zoneState": {
"available": true
},
"zoneName":"zone_01"
},
{
"hosts": null,
"zoneState": {
"available": true
},
"zoneName": "zone_01"
}
]
}
根据实际需要选择可用区,并记录可用区的zoneName。
确定待创建云服务器的规格。
查询云服务器规格信息。
接口相关信息
URI格式:GET /v2.1/{project_id}/flavors/detail{?minDisk,minRam,is_public,sort_key,sort_dir}
其中,“?”后的字段为查询规格时可选的查询检索参数,详情请参见查询云服务器规格详情列表。
请求示例
GET https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/flavors/detail
{endpoint}信息请从地区和终端节点获取。
响应示例
{
"flavors": [
{
"name": "c1.2xlarge",
"links": [
{
"href": "https://xxx/v2.1/74610f3a5ad941998e91f076297ecf27/flavors/c1.2xlarge",
"rel": "self"
},
{
"href": "https://xxx/74610f3a5ad941998e91f076297ecf27/flavors/c1.2xlarge",
"rel": "bookmark"
}
],
"ram": 8192,
"OS-FLV-DISABLED:disabled": false,
"vcpus": 8,
"swap": "",
"os-flavor-access:is_public": true,
"rxtx_factor": 1,
"OS-FLV-EXT-DATA:ephemeral": 0,
"disk": 0,
"id": "c1.2xlarge"
}
]
}
根据实际需要选择规格,并记录规格的ID。
确定待创建云服务器使用的镜像。
查询镜像。
接口相关信息
URI格式:GET /v2.1/{project_id}/images/detail
详情请参见查询镜像列表详情。
请求示例
GET https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/images/detail
{endpoint}信息请从地区和终端节点获取。
响应示例
{
"images": [
{
"OS-EXT-IMG-SIZE:size": 0,
"metadata": {
"__os_type": "Linux",
"hw_vif_multiqueue_enabled": "true",
"__imagetype": "gold",
"__quick_start": "true",
"virtual_env_type": "FusionCompute",
"__support_xen": "true",
"__support_kvm": "true",
"__image_source_type": "uds",
"__platform": "EulerOS",
"__os_version": "EulerOS 2.2 64bit",
"__os_bit": "64",
"__isregistered": "false"
},
"created": "2018-05-14T06:13:50Z",
"minRam": 0,
"name": "DBS-MySQL-Image_2.1.3.3",
"progress": 100,
"links": [
{
"rel": "self",
"href": "https://None/v2.1/74610f3a5ad941998e91f076297ecf27/images/11e8f727-d439-4ed1-b3b8-33f46c0379c4"
},
{
"rel": "bookmark",
"href": "https://None/74610f3a5ad941998e91f076297ecf27/images/11e8f727-d439-4ed1-b3b8-33f46c0379c4"
},
{
"rel": "alternate",
"href": "https://None/images/11e8f727-d439-4ed1-b3b8-33f46c0379c4",
"type": "application/vnd.openstack.image"
}
],
"id": "11e8f727-d439-4ed1-b3b8-33f46c0379c4",
"updated": "2018-05-14T06:13:52Z",
"minDisk": 40,
"status": "ACTIVE"
}
]
}
根据需要选择镜像,并记录镜像ID。
确定云服务器的网络信息。
查询网络。
接口相关信息
URI格式:GET /v2.1/{project_id}/os-networks
详情请参见查询网络列表。
请求示例
GET https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/os-networks
{endpoint}信息请从地区和终端节点获取。
响应示例
{
"networks": [
{
"id": "07a9557d-4256-48ae-847c-415a9c8f7ff6",
"label": "b_tt3_td1b",
"broadcast": null,
"cidr": null,
"dns1": null,
"dns2": null,
"gateway": null,
"netmask": null,
"cidr_v6": null,
"gateway_v6": null,
"netmask_v6": null
}
]
}
根据需要选择网络,并记录网络ID。
设置密钥对登录方式。
如需设置为密码登录方式,请直接跳转至7。
创建密钥对。
接口相关信息
URI格式:POST /v2.1/{project_id}/os-keypairs
详情请参见创建和导入SSH密钥。
请求示例
POST https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/os-keypairs
{endpoint}信息请从地区和终端节点获取。
Body:
{
"keypair": {
"type": "ssh",
"name": "demo1",
"user_id": "fake"
}
}
响应示例
{
"keypair": {
"public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCrR5Gcwlh5ih7JOvzIUuQxS5qzWWPMYHeDXkDKSQ9W5pumOV05SiO3WCswnaQ5xMdOl31mNiHtwlwq9dJi7X6jJBB2shT******************************************************************************************************************************************************************************************************************************************************************************************************* Generated-by-Nova\n",
"private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEogIBAAKCAQEAq0eRnMJYeYoeyTr8yFLkMUuas1ljzGB3g15AykkPVuabpjld\nOUojt1grMJ2kOcTHTpd9ZjYh7cJcKvXSYu1+oyQQdrIUw/tNBuVrsJAWxVOAi77d\nQeOLtDVImkyd+TQL1tv+F76V5vTsIkNweYHumWOxLIt/FJ4fqZG4T5GMTQQivMqD\npaI0IVrO+Wm3cWQYvNdf/EcC3DYhYqHANkRsbUYwXaREnI/tU1PjnH2XUJ69ABWz\ntdc+8sXyMoMMM1U4FLiTWzGyh0rUKkW5JXzJR2OEQT0IG+0Tf2Glyk0El0/OJPg/\ncZQzaO1o+H8DiUzs/7Pz72yDqo0R7fQ+mOCCn***********************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************\n-----END RSA PRIVATE KEY-----\n",
"user_id": "f79791beca3c48159ac2553fff22e166",
"name": "demo1",
"fingerprint": "57:a7:a2:ed:5f:aa:e7:**:**:**:**:**:**:**:**:**"
}
}
导入密钥。
接口相关信息
URI格式:POST /v2.1/{project_id}/os-keypairs
详情请参见创建和导入SSH密钥。
请求示例
POST https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/os-keypairs
{endpoint}信息请从地区和终端节点获取。
Body:
{
"keypair": {
"public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDY8wMTdBYiJgi62o6eShoOlSKx3CZ3cE6PHisDblfK3Y0Bg7EHV7iV9c74pqsrIhK0xuGUuO1NxDQWbkwLTPN4F9Iy5CI********************************************************************************************************************************************************************************************************************************************************* Generated-by-Nova\n",
"type": "ssh",
"name": "demo2",
"user_id": "fake"
}
}
响应示例
{
"keypair": {
"public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDY8wMTdBYiJgi62o6eShoOlSKx3CZ3cE6PHisDblfK3Y0Bg7EHV7iV9c74pqsrIhK0xuGUuO1NxDQWbkwLTPN4F9Iy5CI********************************************************************************************************************************************************************************************************************************************************* Generated-by-Nova\n",
"user_id": "f79791beca3c48159ac2553fff22e166",
"name": "demo2",
"fingerprint": "dd:44:45:49:d9:f6:4f:**:**:**:**:**:**:**:**:**"
}
}
记录响应消息体中的name信息。如本例中为“demo2”。
创建密钥对登录鉴权的云服务器。
接口相关信息
URI格式:POST /v2.1/{project_id}/servers
接口约束及请求参数说明详情,请参见创建云服务器。
说明:
本示例是指定image创建云服务器,因此:
block_device_mapping_v2中,“source_type”需设置为“image”,“uuid”设置为选择的镜像ID,“destination_type”设置为“volume”,“boot_index”设置为“0”。
“volume_size”应大于等于镜像元数据中指定的最小值。
请求示例
POST https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/servers
{endpoint}信息请从地区和终端节点获取。
Body:
{
"server": {
"flavorRef": "c1.large",
"name": "zttestvm1",
"block_device_mapping_v2": [{
"source_type": "image",
"destination_type": "volume",
"volume_type": "SSD",
"volume_size": "40",
"delete_on_termination": "true",
"uuid": "11e8f727-d439-4ed1-b3b8-33f46c0379c4",
"boot_index": "0"
}],
"networks": [{
"uuid": "fb68519f-a7c0-476e-98d4-2e4cf6de6def"
}],
"key_name": "demo2",
"availability_zone": "az_test_01"
}
}
响应示例
{
"server": {
"security_groups": [
{
"name": "default"
}
],
"OS-DCF:diskConfig": "MANUAL",
"links": [
{
"rel": "self",
"href": "https://None/v2.1/74610f3a5ad941998e91f076297ecf27/servers/6d311127-bce1-48db-bf0f-cac9f8f7f077"
},
{
"rel": "bookmark",
"href": "https://None/74610f3a5ad941998e91f076297ecf27/servers/6d311127-bce1-48db-bf0f-cac9f8f7f077"
}
],
"id": "6d311127-bce1-48db-bf0f-cac9f8f7f077",
"adminPass": "**********"
}
}
设置密码登录方式。
使用非cloud-init镜像创建云服务器时,Windows和Linux系统都使用“adminPass”参数实现密码注入。
使用cloud-init镜像创建云服务器时:
对于Linux系统,只能使用“user_data”进行密码注入,“user_data”字符串长度小于65535,且必须是base64加密的;
对于Windows系统,只能通过元数据“admin_pass”进行密码注入。
创建密码方式登录鉴权的弹性云服务器。
说明:
本示例是指定image创建弹性云服务器,因此:
block_device_mapping_v2中,“source_type”需设置为“image”,“uuid”设置为选择的镜像ID,“destination_type”设置为“volume”,“boot_index”设置为“0”。
“volume_size”应大于等于镜像元数据中指定的最小值。
创建非cloud-init镜像、密码方式登录鉴权的弹性云服务器。
接口相关信息
URI格式:POST /v2.1/{project_id}/servers
接口约束及请求参数说明详情,请参见创建云服务器。
请求示例
POST https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/servers
{endpoint}信息请从地区和终端节点获取。
Body:
{
"server": {
"flavorRef": "c1.large",
"name": "zttestvm1",
"adminPass": "$ADMIN_PASS", //建议在配置文件或者环境变量中密文存放,使用时解密,确保安全
"block_device_mapping_v2": [{
"source_type": "image",
"destination_type": "volume",
"volume_type": "SSD",
"volume_size": "40",
"delete_on_termination": "true",
"uuid": "11e8f727-d439-4ed1-b3b8-33f46c0379c4",
"boot_index": "0"
}],
"networks": [{
"uuid": "fb68519f-a7c0-476e-98d4-2e4cf6de6def"
}],
"availability_zone": "az_test_01"
}
}
响应示例
{
"server": {
"security_groups": [
{
"name": "default"
}
],
"OS-DCF:diskConfig": "MANUAL",
"links": [
{
"rel": "self",
"href": "https://None/v2.1/74610f3a5ad941998e91f076297ecf27/servers/73991cff-37c6-491a-9a8a-377397729fce"
},
{
"rel": "bookmark",
"href": "https://None/74610f3a5ad941998e91f076297ecf27/servers/73991cff-37c6-491a-9a8a-377397729fce"
}
],
"id": "73991cff-37c6-491a-9a8a-377397729fce",
"adminPass": "***********"
}
}
创建cloud-init镜像(以Linux为例)、密码方式登录鉴权的弹性云服务器。
接口相关信息
URI格式:POST /v2.1/{project_id}/servers
接口约束及请求参数说明详情,请参见创建云服务器。
请求示例
POST https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/servers
{endpoint}信息请从地区和终端节点获取。
Body:
{
"server": {
"flavorRef": "c1.large",
"name": "zttestvm2",
"user_data":"IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRuaERlcUIkajBkelVMbkFrbWo4bWlFREFzT0VONkVPdGg1RmdqWnQybUVWZVRocC5OVDJXelZVdzFuNzhnL3dNdDE0dVpSQ1V3LzhHS3VGdEViQ0lPQS5vN1BZQzEnIHwgY2hwYXNzd2QgLWU7",
"block_device_mapping_v2": [{
"source_type": "image",
"destination_type": "volume",
"volume_type": "SSD",
"volume_size": "40",
"delete_on_termination": "true",
"uuid": "11e8f727-d439-4ed1-b3b8-33f46c0379c4",
"boot_index": "0"
}],
"networks": [{
"uuid": "fb68519f-a7c0-476e-98d4-2e4cf6de6def"
}],
"availability_zone": "az_test_01"
}
}
响应示例
{
"server": {
"security_groups": [
{
"name": "default"
}
],
"OS-DCF:diskConfig": "MANUAL",
"links": [
{
"rel": "self",
"href": "https://None/v2.1/74610f3a5ad941998e91f076297ecf27/servers/7c11f362-cc96-4306-85b6-b432a639ca5e"
},
{
"rel": "bookmark",
"href": "https://None/74610f3a5ad941998e91f076297ecf27/servers/7c11f362-cc96-4306-85b6-b432a639ca5e"
}
],
"id": "7c11f362-cc96-4306-85b6-b432a639ca5e",
"admin_pass": "J3xMSivHCuq5"
}
}
确认云服务器创建成功。
接口相关信息
URI格式:GET /v2.1/{project_id}/servers/{server_id}
详情请参见查询云服务器详情。
请求示例
GET https://{endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/servers/0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6
其中:
0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6为创建的云服务器UUID。
{endpoint}信息请从地区和终端节点获取。
响应示例
{
"server": {
"tenant_id": "74610f3a5ad941998e91f076297ecf27",
"addresses": {
"2a6f4aa6-d93e-45f5-a8cb-b030dbf8cd68": [
{
"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:88:01:1b",
"OS-EXT-IPS:type": "fixed",
"addr": "192.168.2.192",
"version": 4
}
]
},
"metadata": {},
"OS-EXT-STS:task_state": null,
"OS-DCF:diskConfig": "MANUAL",
"OS-EXT-AZ:availability_zone": "az_test_01",
"links": [
{
"rel": "self",
"href": "https://None/v2.1/74610f3a5ad941998e91f076297ecf27/servers/0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6"
},
{
"rel": "bookmark",
"href": "https://None/74610f3a5ad941998e91f076297ecf27/servers/0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6"
}
],
"OS-EXT-STS:power_state": 1,
"id": "0c71c0da-8852-4c56-a1d1-3a9b9bcb6da6",
"os-extended-volumes:volumes_attached": [
{
"id": "b551445a-e749-4d53-932a-638a455cb6c3"
}
],
"OS-EXT-SRV-ATTR:host": "pod1_test_01",
"image": {
"links": [
{
"rel": "bookmark",
"href": "https://None/74610f3a5ad941998e91f076297ecf27/images/11e8f727-d439-4ed1-b3b8-33f46c0379c4"
}
],
"id": "11e8f727-d439-4ed1-b3b8-33f46c0379c4"
},
"OS-SRV-USG:terminated_at": null,
"accessIPv4": "",
"accessIPv6": "",
"created": "2018-05-25T01:47:11Z",
"hostId": "b2792bef989888d2df1f51bff81de5ac58a4117f4e9ec3059c1a0410",
"OS-EXT-SRV-ATTR:hypervisor_hostname": "nova001@36",
"key_name": null,
"flavor": {
"links": [
{
"rel": "bookmark",
"href": "https://None/74610f3a5ad941998e91f076297ecf27/flavors/c1.large"
}
],
"id": "c1.large"
},
"security_groups": [
{
"name": "default"
}
],
"config_drive": "",
"OS-EXT-STS:vm_state": "active",
"OS-EXT-SRV-ATTR:instance_name": "instance-001883cd",
"user_id": "f79791beca3c48159ac2553fff22e166",
"name": "zttestvm1",
"progress": 0,
"OS-SRV-USG:launched_at": "2018-05-25T01:47:55.755922",
"updated": "2018-05-25T01:47:55Z",
"status": "ACTIVE"
}
}
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱)[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]