1. 接口描述
本接口(ModifyComputeEnv)用于修改计算环境的期望节点数量。
接口请求域名:batch.api.qcloud.com
2. 输入参数
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Version | String | 是 | API版本号 |
EnvId | String | 是 | 计算环境唯一标识 |
DesiredComputeNodeCount | Integer | 是 | 计算节点期望个数 |
3. 容量变更策略
扩容
当输入参数中的 DesiredComputeNodeCount 大于当前计算环境的 DesiredComputeNodeCount 时,计算环境进行扩容,创建新的计算节点。缩容
当输入参数中的 DesiredComputeNodeCount 小于当前计算环境的 DesiredComputeNodeCount 时(二者差值的绝对值为n),计算环境进行缩容,准备销毁 n 个计算节点。
由于生命周期的限制,状态为 CREATED, RUNNING, ABNORMAL 的计算节点可以发起销毁,其他状态的计算节点禁止发起销毁。如果当前可销毁的计算节点数量小于 n,则接口会返回错误。保持不变
当输入参数中的 DesiredComputeNodeCount 等于当前计算环境的 DesiredComputeNodeCount 时,计算环境中节点数量保持不变。
ComputeNode 状态
状态 | 说明 | 备注 |
---|---|---|
SUBMITTED | 已提交 | 初始化状态 |
CREATING | 创建中 | 发起创建流程 |
CREATED | 创建成功 | 创建成功,但是尚未收到心跳 |
CREATION_FAILED | 创建操作失败 | 创建失败,区别于 ABNORMAL 状态 |
RUNNING | 运行中 | 正常运行 |
ABNORMAL | 异常 | 一段时间未收到心跳 |
DELETING | 删除中 | 发起销毁流程 |
4. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 唯一请求ID |
5. 错误码
错误码 | 描述 |
---|---|
ComputeEnvNotFound | 指定计算环境不存在。 |
InvalidBatchEnvId.Malformed | 非法的计算环境ID格式。 |
ComputeEnvAcceptOtherRequestException | 处理其他请求,禁止创建操作。 |
NoEnoughCpuQuota | 扩容时,CPU配额不足。 |
ComputeNodeForbidTerminate | 禁止终止计算节点。 |
NotEnoughComputeNodesToTerminate | 缩容时,缩容数大于现有计算节点数。 |
InvalidParameterValue.Negative | 非法的负值参数。 |
InternalServerError | 内部服务错误。 |