API文档
容器云相关接口
容器实例
创建容器实例

1. 创建容器实例

本接口用于创建一个或多个指定配置的容器实例。

  1. 预付费容器实例的购买会预先从您的账户中扣除本次购买容器实例所需金额,按小时后付费容器实例购买会预先冻结本次所购买容器实例一小时所需金额。所以,在调用本接口前请确认当前账户余额是否充足,如果余额不充足会返回【余额不足提示】。
  2. 本接口为异步接口。当创建容器实例请求下发成功后会返回一个或多个异步任务进度信息(jobUuid)。通过 jobUuid 可以查询出当前异步任务执行情况。如果异步任务正在执行,返回的内容里 done=false、success=false,并有进度值显示;如果异步任务执行成功完成,返回的内容里 done=true、success=true;如果异步任务执行失败,返回的内容里 done=true,success=false。

1.1. 接口说明

本接口所属服务类型为 ackcs

本接口操作类型为 CreateServices

1.1.1. 请求路径

POST {baseUrl}/v3/ackcs/CreateServices

1.1.2. 请求体

{
	"aliasName": "kcs-pzunmwju",
	"autoContinue": false,
	"billingType": "PrePaid",
	"imageUuid": "ackcs-00x2qyd3",
	"payPeriod": 1,
	"serviceModel": "rtx3090.epyc7402.xlarge",
	"zoneCode": "cn-zhongwei-ac",
	"count":1
}

请求体内容说明

属性名属性类型是否必须默认值说明
zoneCodeString智算云可用区编码可通过可用区查询接口获取
countInteger1本次创建同一规格容器实例个数
aliasNameString容器实例别名。如果创建的是多台容器实例,每台容器实例的别名是【指定名称+"-"+序号】的形式
serviceModelString容器实例规格信息可通过容器实例规格查询接口获取
imageUuidString使用的镜像 uuid 可通过镜像查询接口获取
billingTypeString通常需要传入按需 PostPaid 和包月 PrePaid 两值其一
payPeriodInteger购买月数,例如:payPeriod=1表示购买1个月
autoContinueBooleanfalse资源到期是否自动续费。true表示到期后自动续费;false表示到期后自动删除

billingType 计费类型

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

1.1.3. 返回内容

{
	"code": 200,
	"message": "创建实例成功",
	"data": [{
		"jobUuid": "req-00001njdvm-00x2qyak",
		"resourceUuid": "ackcs-00x2qyak",
		"type": "Create",
		"done": false,
		"success": false
	}]
}
⚠️

如果您指定的参数count>1,则表示批量创建相同规格的容器实例。

返回内容说明

属性名属性类型说明
codeInteger返回码。正常返回 200,异常返回500或其他业务错误码
messageString返回信息
dataArray异步任务进度信息

异步任务进度信息

属性名属性类型说明
jobUuidString异步任务唯一编码
successBoolean异步任务是否执行成功
typeString异步任务类型
doneBoolean异步任务是否执行完成
resourceUuidString异步任务所处理的资源 Uuid