文档中心 > 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"

    ]

}