1. 创建云服务器

本接口用于创建一个或多个指定配置的云服务器。

预付费云服务器的购买会预先从您的账户中扣除本次购买云服务器所需金额，按小时后付费云服务器购买会预先冻结本次所购买云服务器一小时所需金额。所以，在调用本接口前请确认当前账户余额是否充足，如果余额不充足会返回【余额不足】。
本接口为异步接口。当创建云服务器请求下发成功后会返回一个或多个异步任务进度信息（jobUuid）。通过 jobUuid 可以查询出当前异步任务执行情况。如果异步任务正在执行，返回的内容里 done=false、success=false，并有进度值显示；如果异步任务执行成功完成，返回的内容里 done=true、success=true；如果异步任务执行失败，返回的内容里 done=true，success=false。
智算云创建的云服务器必须包含一个系统盘。数据云盘最多可同时创建10块，请根据自己的需求创建数据云盘。
智算云创建云服务器传入的密码信息为密文。设置密码是一个可选项，如果您创建云服务器时未指定密码，则会为您自动生成一个随机密码。生成的随机密码可以从云服务器查询列表接口找到。
弹性公网 IP 和云盘相关参数为可选参数。

💡

云服务器密码设置规则：

密码长度 12-16 位。
密码要同时包含大写字母、小写字母、数字和特殊字符。
特殊字符@$.?最多3个。
密码不支持中文

请把您的密码转换成16进制字符串，传入到云服务器创建password参数中。

密码转换成16进制字符串详见各个SDK内建工具函数

JavaSDK

PythonSDK

1.1. 接口说明

本接口所属服务类型为 ecs

本接口操作类型为 RunInstances

1.1.1. 请求路径

POST {baseUrl}/v3/ecs/RunInstances

1.1.2. 请求体

{
  "zoneCode": "cn-zhongwei-a",
  "count": 10,
  "aliasName": "ecs-lmymjrsg",
  "ecsModel": "ecs.sl-gpu.rtx3090.10c32g.1c24g",
  "imageUuid": "be38df61-afde-4db6-8bd5-1faa2d886cc9",
  "eip": {
    "networkSize": 5,
    "networkType": "Flow"
  },
  "ebs": [
    {
      "diskType": "SSD",
      "diskSize": 20
    }
  ],
  "rootDiskType": "SSD",
  "rootDiskSize": "200",
  "billingType": "PostPaid",
  "payPeriod": 0,
  "autoContinue": false,
  "password": "3165666e50492e67464e616c49614150"
}

请求体内容说明

属性名	属性类型	是否必须	默认值	说明
zoneCode	String	是	无	智算云可用区编码可通过可用区查询接口获取
count	Integer	否	1	本次创建同一规格云服务器个数
aliasName	String	是	无	云服务器别名。如果创建的是多台云服务器，每台云服务器的别名是【指定名称+"-"+序号】的形式
ecsModel	String	是	无	云服务器规格信息可通过云服务器规格查询接口获取
imageUuid	String	是	无	使用的镜像 uuid 可通过镜像查询接口获取
eip	EIPInput	否	无	弹性公网 IP 请求参数
ebs	List<EBSInput>	否	无	附带的数据云盘请求参数
rootDiskType	String	是	无	系统盘类型可通过云盘规格查询接口获取，可用的值为 HDD 性能优化型云盘和 SSD 高性能云盘
rootDiskSize	Integer	是	无	系统盘大小，单位 GB。系统盘大小一定要大于所选镜像支持的最小磁盘大小值。支持的值在 20-500 之间。具体大小需要参考使用的镜像支持的最小磁盘大小，通常建议是镜像支持的最小磁盘大小+10GB
billingType	String	是	无	通常需要传入按需 PostPaid 和包月 PrePaid 两值其一
payPeriod	Integer	否	无	购买月数，例如：payPeriod=1表示购买1个月
autoContinue	Boolean	否	false	资源到期是否自动续费。true表示到期后自动续费;false表示到期后自动删除
password	String	否	无	建议使用自定义密码,密码设置规则详见上面说明

弹性公网 IP 请求参数EIPInput说明

属性名	属性类型	是否必须	默认值	说明
networkSize	Integer	是	无	网络的带宽大小，单位 Mbps
networkType	String	是	无	网络类型

网络类型详见网络类型

数据云盘请求参数EBSInput说明

属性名	属性类型	是否必须	默认值	说明
diskType	String	是	无	数据云盘类型可通过云盘规格接口查询出云盘类型
diskSize	Integer	是	无	数据云盘大小，单位 GB。范围一般在 20-32768GB 之间

billingType 计费类型

PostPaid。按小时后付费。
PrePaid。预付费包月.

1.1.3. 返回内容

{
  "code": 200,
  "message": "成功创建云服务器",
  "data": [
    {
      "jobUuid": "7732308d3c1e40718368a97dab9affe9",
      "success": false,
      "progress": 0,
      "type": "CreateECS",
      "done": false,
      "resourceUuid": "5b269c60-cf6a-42ce-8438-7877c57ec8a6"
    }
  ]
}

⚠️

如果您指定的参数count>1，则表示批量创建相同规格的云服务器。

返回信息的message中会显示本次批量创建的结果。例如 {"TotalCount":2,"FailureCount":0,"SuccessCount":2,"FailureMsgs":[]}

返回内容说明

属性名	属性类型	说明
code	Integer	返回码。正常返回 200，异常返回500或其他业务错误码
message	String	返回信息
data	Array	异步任务进度信息

异步任务进度信息

属性名	属性类型	说明
jobUuid	String	异步任务唯一编码
success	Boolean	异步任务是否执行成功
progress	Double	异步任务执行进度。0-100%
type	String	异步任务类型
done	Boolean	异步任务是否执行完成
resourceUuid	String	异步任务所处理的资源 Uuid

异步任务执行状态请详见异步任务.

创建云服务器询价查询云服务器列表