文档
测试

创建虚拟机

POST
/v2.1/servers

接口描述

创建一个虚拟机实例。

请求头

参数名
类型
描述
必填
X-Auth-Token
sring
Token。
必填

请求参数

参数名
类型
描述
必填
server
object
虚拟机对象。
必填
name
string
虚拟机名称
必填
imageRef
string
用于服务器实例的映像的UUID。 从卷启动时不需要此操作。 在所有其他情况下,它都是必需的,并且必须是有效的UUID,否则API将返回400。
必填
flavorRef
string
服务器实例的类型引用(提供ID(包括UUID)或完整URL)。
必填
availability_zone
string
创建服务器的可用性区域。 设置资源时,可以指定要从哪个可用性区域构建实例。 通常,管理员用户将使用可用性区域将OpenStack计算主机划分为逻辑组。
必填
key_name
string
ssh密钥对名称。
可选
OS-DCF:diskConfig
string
控制在创建,重建或调整服务器大小时API如何对磁盘进行分区。 服务器从创建映像的服务器继承OS-DCF:diskConfig值,映像从创建映像的服务器继承OS-DCF:diskConfig值。 要覆盖继承的设置,可以将此属性包含在服务器创建,重建或调整大小请求的请求主体中。 如果映像的OS-DCF:diskConfig值为MANUAL,则无法从该映像创建服务器并将其OS-DCF:diskConfig值设置为AUTO。
必填
metadata
object
元数据。 元数据键和值的最大大小为255个字节。
必填
My Server Name
string
实例的hostname。
必填
security_groups
array
一个或多个安全组。 在名称属性中指定安全组的名称。 如果省略此属性,则API将在默认安全组中创建服务器。 所请求的安全组不应用于预先存在的端口。
必填
name
string
安全组名称。
必填
user_data
string
启动时使用的配置信息或脚本。 必须为Base64编码。 限制为65535个字节。
必填
networks
array
要使用的网络。
必填
uuid
string
要为服务器实例提供用于网络的NIC,请在网络对象的uuid属性中指定网络的UUID。
必填

响应参数

参数名
类型
描述
必填
server
object
虚拟机对象。
必填
security_groups
array
一个或多个安全组对象
必填
name
string
安全组名称
必填
OS-DCF:diskConfig
string
磁盘配置。AUTO代表该API用目标分区磁盘大小的单个分区构建服务器。 API会自动调整文件系统以适合整个分区。MANUAL代表API通过使用源映像中的分区方案和文件系统来构建服务器。 如果目标虚拟机类型的磁盘更大,则API不会对剩余的磁盘空间进行分区。
必填
id
string
服务器的UUID。
必填
links
array
资源链接对象。
必填
href
string
链接地址。
必填
rel
string
资源名称。
必填
adminPass
string
虚拟机的管理员密码。
必填

说明 / 示例

### API前缀的获取方式 >d 在之前的Token返回值中,token->catalog->type="compute"的同级endpoints->region="public"的url中的ip:port为实际的API前缀。默认PORT为8774。 ### 可用的一些数据 由于硬件尚未到位,以下数据均不含GPU |参数名称|内容|描述| |-|-|-| |imageRef|6fe4908a-6065-45ee-99b6-10b43cffb2f3|专用于GPUHome的虚拟机系统镜像,含有必要的API接口和Python3运行环境| |imageRef|270f6c30-1cab-4eda-b3db-3222d595503d|专用于ES的虚拟机系统镜像,含必要的API接口。| |flavorRef|7b78e793-35ae-4365-9cdd-ecbf31c0e3e7|1c8g100g(CPU内核数,内存大小,硬盘大小,下同)| |flavorRef|653f152f-51b6-4ca2-9671-ddbb9fca837d|2c4g100g| |flavorRef|5d6fc4fb-a3e6-4e24-a421-3d1ee7a8ece0|2c16g100G| |flavorRef|7068e475-3c60-40d7-b845-5cfaed0d6c00|4c8g100g| |flavorRef|70df7504-5c92-45cb-a75a-fca8d186fad7|4c16g80g| |flavorRef|4372ce9b-63d4-4ec7-9928-9aed36e8a7b6|6c24g1t| |networks.uuid|2043ff86-0450-4851-ab07-1e1ed01c6c5b|系统内部网络,外部不可访问,需附加浮动ip| |user_data|IyEvYmluL3NoCnBhc3N3ZCBlczw8RU9GCmRraEAyMDE5CmRraEAyMDE5CkVPRgpwYXNzd2Qgcm9vdDw8RU9GCmRraEAyMDE5CmRraEAyMDE5CkVPRgpzZWQgLWkgJ3MvUGFzc3dvcmRBdXRoZW50aWNhdGlvbiBuby9QYXNzd29yZEF1dGhlbnRpY2F0aW9uIHllcy9nJyAvZXRjL3NzaC9zc2hkX2NvbmZpZwpzZWQgLWkgJ3MvI1Blcm1pdFJvb3RMb2dpbiB5ZXMvUGVybWl0Um9vdExvZ2luIHllcy9nJyAvZXRjL3NzaC9zc2hkX2NvbmZpZwojc2VkIC1pICdzL1VzZVBBTS8jVXNlUEFNL2cnIC9ldGMvc3NoL3NzaGRfY29uZmlnCnNlcnZpY2Ugc3NoZCByZXN0YXJ0|系统参数| ### 请求示例 ```json { "server" : { “name” : “new-server-test”, “imageRef” : “003e31e2-1a11-4313-b048-e85fd60f2c72”, “flavorRef” : “927e2196-82c5-4a21-8a90-32b5099aeb26”, "availability_zone": "nova", “key_name”: “mykey”, "OS-DCF:diskConfig": "AUTO", "metadata" : { “My Server Name” : “hanlpTest“ }, "security_groups": [ { “name”: “default“ } ], “user_data” : “IyEvYmluL3NoDQpwYXNzd2QgY2VudG9zJmx0OyZsdDtFT0YNCmRraEAyMDE5DQpka2hAMjAxOQ0KRU9GDQpwYXNzd2Qgcm9vdCZsdDsmbHQ7RU9GDQpka2hAMjAxOQ0KZGtoQDIwMTkNCkVPRg0Kc2VkIC1pICYjMzk7cy9QYXNzd29yZEF1dGhlbnRpY2F0aW9uIG5vL1Bhc3N3b3JkQXV0aGVudGljYXRpb24geWVzL2cmIzM5OyAvZXRjL3NzaC9zc2hkX2NvbmZpZw0Kc2VkIC1pICYjMzk7cy8jUGVybWl0Um9vdExvZ2luIHllcy9QZXJtaXRSb290TG9naW4geWVzL2cmIzM5OyAvZXRjL3NzaC9zc2hkX2NvbmZpZw0KI3NlZCAtaSAmIzM5O3MvVXNlUEFNLyNVc2VQQU0vZyYjMzk7IC9ldGMvc3NoL3NzaGRfY29uZmlnDQpzZXJ2aWNlIHNzaGQgcmVzdGFydA==”, "networks" : [{ “uuid” : “2043ff86-0450-4851-ab07-1e1ed01c6c5b“ }] } } ``` ### 响应示例 ```json { "server": { "security_groups": [ { "name": "default" } ], "OS-DCF:diskConfig": "AUTO", "id": "1b3a4b82-0f31-423d-9e9c-209be2eda17a", "links": [ { "href": "http://10.20.30.40:8774/v2.1/servers/1b3a4b82-0f31-423d-9e9c-209be2eda17a", "rel": "self" }, { "href": "http://10.20.30.40:8774/servers/1b3a4b82-0f31-423d-9e9c-209be2eda17a", "rel": "bookmark" } ], "adminPass": "ss7qvEFZnGQZ" } } ```