1. 创建容器实例
本接口用于创建一个或多个指定配置的容器实例。
- 预付费容器实例的购买会预先从您的账户中扣除本次购买容器实例所需金额,按小时后付费容器实例购买会预先冻结本次所购买容器实例一小时所需金额。所以,在调用本接口前请确认当前账户余额是否充足,如果余额不充足会返回【余额不足提示】。
- 本接口为异步接口。当创建容器实例请求下发成功后会返回一个或多个异步任务进度信息(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
}
请求体内容说明
属性名 | 属性类型 | 是否必须 | 默认值 | 说明 |
---|---|---|---|---|
zoneCode | String | 是 | 无 | 智算云可用区编码可通过可用区查询接口获取 |
count | Integer | 否 | 1 | 本次创建同一规格容器实例个数 |
aliasName | String | 是 | 无 | 容器实例别名。如果创建的是多台容器实例,每台容器实例的别名是【指定名称+"-"+序号】的形式 |
serviceModel | String | 是 | 无 | 容器实例规格信息可通过容器实例规格查询接口获取 |
imageUuid | String | 是 | 无 | 使用的镜像 uuid 可通过镜像查询接口获取 |
billingType | String | 是 | 无 | 通常需要传入按需 PostPaid 和包月 PrePaid 两值其一 |
payPeriod | Integer | 否 | 无 | 购买月数,例如:payPeriod=1表示购买1个月 |
autoContinue | Boolean | 否 | false | 资源到期是否自动续费。true表示到期后自动续费;false表示到期后自动删除 |
billingType 计费类型
- PostPaid。 按小时后付费。
- PrePaid。 预付费包月.
1.1.3. 返回内容
{
"code": 200,
"message": "创建实例成功",
"data": [{
"jobUuid": "req-00001njdvm-00x2qyak",
"resourceUuid": "ackcs-00x2qyak",
"type": "Create",
"done": false,
"success": false
}]
}
⚠️
如果您指定的参数count>1,则表示批量创建相同规格的容器实例。
返回内容说明
属性名 | 属性类型 | 说明 |
---|---|---|
code | Integer | 返回码。正常返回 200,异常返回500或其他业务错误码 |
message | String | 返回信息 |
data | Array | 异步任务进度信息 |
异步任务进度信息
属性名 | 属性类型 | 说明 |
---|---|---|
jobUuid | String | 异步任务唯一编码 |
success | Boolean | 异步任务是否执行成功 |
type | String | 异步任务类型 |
done | Boolean | 异步任务是否执行完成 |
resourceUuid | String | 异步任务所处理的资源 Uuid |