有奖捉虫:云通信与企业服务文档专题,速来> HOT

1. 接口描述

本接口(ModifyComputeEnv)用于修改计算环境的期望节点数量。
接口请求域名:batch.api.qcloud.com

2. 输入参数

名称 类型 是否必选 描述
Version String API版本号
EnvId String 计算环境唯一标识
DesiredComputeNodeCount Integer 计算节点期望个数

3. 容量变更策略

  1. 扩容
    当输入参数中的 DesiredComputeNodeCount 大于当前计算环境的 DesiredComputeNodeCount 时,计算环境进行扩容,创建新的计算节点。

  2. 缩容
    当输入参数中的 DesiredComputeNodeCount 小于当前计算环境的 DesiredComputeNodeCount 时(二者差值的绝对值为n),计算环境进行缩容,准备销毁 n 个计算节点。
    由于生命周期的限制,状态为 CREATED, RUNNING, ABNORMAL 的计算节点可以发起销毁,其他状态的计算节点禁止发起销毁。如果当前可销毁的计算节点数量小于 n,则接口会返回错误。

  3. 保持不变
    当输入参数中的 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 内部服务错误。