InstanceCreate【新建云主机】¶
新建云主机:可指定镜像、网络、CPU核数、核数、云主机名称、密码、计费方式等来创建云主机。如果不指定任何必要条件,则会返回错误信息。
Request Parameters
Parameter name | Type | Description | Required |
---|---|---|---|
action | String | API 标识符 | Yes |
count | String | 创建的云主机数量 | Yes |
admin_pass | String | 云主机登录密码 | Yes |
security_group_ids | String | 安全组 (防火墙) ID | Yes |
name | String | 云主机名称 | Yes |
availability_zone | String | 可使用区域 | Yes |
network_id | Array | 网络(交换机) ID | Yes |
subnet_id | String | 子网 ID | Yes |
fixed_ip_type | String | 网卡IP分配方式,有效值有dhcp、static dhcp:自动分配IP地址,参数ipaddr不需要指定IP地址
static:指定静态IP地址,参数ipaddr需指定有效IP地址
|
Yes |
ipaddr | String | IP地址,参数fixed_ip_type的值为static时,需要指定有效IP地址 | Yes |
image_id | String | 镜像 ID | Yes |
keypair_id | String | 密钥 ID | Yes |
flavor | String | 云主机配置的模板名称 | Yes |
disk | String | 云主机大小 | Yes |
billing_type | String | 计费类型,有效值有:hour、month | Yes |
is_public | String | 镜像是否为公有镜像,有效值有:is_public,is_private | Yes |
cpu | Integer | CPU核数 | Yes |
ram | Integer | 内存大小 | Yes |
Response Elements
Name | Type | Description |
---|---|---|
message | String | 执行结果信息 |
code | Integer | HTTP Resonpe响应状态码 |
Example
Example Request:
Request Headers:
POST /api/ HTTP/1.1
Origin: https://console.plcloud.com
X-CSRFToken: 6An6xEuOJqW6dVDtlgzZr6FqgkSbJmqp
Content-Type: application/json
JSON Data:
{
"action": "InstanceCreate",
"count": "1",
"admin_pass": "Aa11111111",
"security_group_ids": "e5a57f37-7229-4aa1-925a-f808296e19d0",
"name": "test",
"availability_zone": "nova",
"network_id": [
"a1465b88-c0c2-49f1-9c63-1282cafe6085"
],
"subnet_id": "dcc01e93-b2c0-44f3-807d-837a0d915ec3",
"fixed_ip_type": "dhcp",
"ipaddr": "",
"image_id": "4bd9f1e5-6093-4ccf-ab82-5186799c4cc2",
"keypair_id": "",
"flavor": "11",
"disk": "20",
"billing_type": "hour",
"is_public": "is_public",
"cpu": 1,
"ram": 2
}
Example Response:
{
"message": "成功",
"code": 200
}