文档中心 > RunEcs
RunEcs

最近更新时间:2023-07-24

请求方法:POST

接口描述: 使用RunEcs创建云主机。


请求参数

Param

名称

数据类型

是否必选

描述

Action

String

是

要执行的操作。取值RunEcs

Body

名称

数据类型

是否必选

描述

regionId

String

是

区域ID

azoneId

String

是

可用区ID

payType

String

是

计费方式

period

int

是

购买租期(月)

vmSpecificationCode

String

是

弹性云主机规格编码

sysDiskSpecificationCode

String

是

系统盘规格编码

sysDiskSize

int

是

系统盘大小(G)

imageId

String

是

镜像ID

imageSpecificationClassCode

String

是

镜像规格族,详见枚举说明

vpcId

String

否

使用的vpc

securityGroupId

String

否

绑定的安全组

bandWidthSpecificationCode

String

否

EIP规格

bandWidthSize

int

否

EIP带宽

password

String

否

云主机初始密码

keyPair

String

否

密钥对ID

instanceName

String

是

实例名称(字母开头,包含字母数字,2到15个字符)

hostName

String

否

虚机hostName,不指定是使用instanceName

description

String

否

虚机描述

baseQuantity

int

是

购买数量

masterEniSubNetId

String

是

主网卡所在子网ID

masterEniName

String

否

主网卡名称

masterEniIp

String

否

主网卡内网IP地址,批量创建主机时,IP地址之间以逗号分隔

secondaryEniSubNetId

String

否

辅助网卡所在子网ID

secondaryEniName

String

否

辅助网卡名称

initialShell

String

否

初始化脚本

dataDisks

object[]

否


+dataDiskSpecificationCode

String

是

数据盘规格

+dataDiskSize

int

是

数据盘大小

+templateId

String

否

如使用整机镜像,需指定源镜像下属的数据盘镜像ID

resourceGroupId

String

否

资源组ID,为空时为默认资源组

affinityId

String

否

启动集ID

tagIds

String[]

否

标签ID
projectId

String

否

项目ID

 

返回参数

名称

类型

描述

RequestId

String

请求ID

orderId

String

订单号

instanceIds

Stirng[]

云主机ID列表


示例

请求示例

POST https://api.unicloud.com/compute/ecs/instances?

Action=RunEcs

&公共请求参数

body

{

"period": 1,

"payType": "YEAR_MONTH",

"regionId": "cn-beijing",

"azoneId": "cn-beijing-a",

"vmSpecificationCode": "ecs.c5.medium",

"sysDiskSpecificationCode": "ebs.hybrid.hdd",

"sysDiskSize": "40",

"bandWidthSpecificationCode":"eip.bgp.static",

"bandWidthSize":10,

"imageId": "centos-imageTest-2",

"imageSpecificationClassCode": "ecs.image.public",

"vpcId": "vpc-9gbq0x14rj1ob",

"securityGroupId": "sg-r1firmbmue2ob",

"password": "qwer1234",

"instanceName": "adsadda",

"hostName": "",

"baseQuantity": "1",

"masterEniSubNetId": "deefbd1f8c684bdda00c82d72b20d7a6",

"dataDisks": [

   {

      "dataDiskSpecificationCode": "ebs.hybrid.hdd",

      "dataDiskSize": 40

   }

 ],

"tagIds": ["4bc2f330-b6a2-4c45-b310-cb209205a0b2"]

}


返回示例

{

    "orderId": "1282481958567882801",

    "instanceIds": [

        "ecs-j01364ji7bgv"

    ]

}