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
}