全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多

节点管理API

更新时间:2018-07-05 11:15:13

AddNodes 批量添加计算节点

请求参数

字段 类型 是否必须 默认值 描述
Action String - 操作接口名,系统规定参数,取值:AddNodes
RegionId String - 地域ID
ClusterId String - 集群ID
Count Integer - 添加的计算节点数量
ComputeSpotStrategy String - 计算节点竞价策略,取值’NoSpot’, ‘SpotWithPriceLimit’, ‘SpotAsPriceGo’
ComputeSpotPriceLimit String - 设置实例的每小时最高价格,取值是数字,浮点数,取值范围是当前的价格区间
ImageOwnerAlias String system 镜像类型,system self others marketplace
ImageId String - 镜像id, 如果ImageType是system, 就只根据OsTag来决定基础镜像ID; 如果是self, others, marketplace, ImageId就是必填的
InstanceType String - ECS实例规格类型
EcsChargeType String PostPaid 集群使用ECS实例的付费类型,PostPaid:按量付费,PrePaid:包年包月。若选择包年包月类型,默认开启自动续费,节点释放后将关闭自动续费。目前仅支持按量付费。
Period Integer - 购买资源的时长,单位为:月。当参数 EcsChargeType 取值为 PrePaid 时才生效且为必选值
PeriodUnit String - 购买资源的时长。可选值 Week/Month
AutoRenew Boolean false true:自动续费;talse:不自动续费
AutoRenewPeriod Integer 1 false 每次自动续费的时长,当参数 AutoRenew 取值 True 时生效

返回参数

公共参数和以下参数:

字段 类型 描述
InstanceIds Array\ 节点ID数组

错误码

Code 解释
InvalidParams 无效的参数
InvalidStatus 集群状态不允许此操作
TooManyNodes 集群节点数超过配额
EcsError ECS接口调用失败
UnknownError 未知错误

DeleteNodes 批量删除计算节点

请求参数

字段 类型 是否必须 默认值 描述
Action String - 操作接口名,系统规定参数,取值:DeleteNodes
RegionId String - 地域ID
ClusterId String - 集群ID
Instance.n.Id String - 第n个(n从1开始编号,可以有多条)要移除的节点实例ID
ReleaseInstance Boolean true 是否释放由EHS创建的实例

返回参数

公共参数。

错误码

Code 解释
InvalidParams 无效的参数
InvalidStatus 集群或节点状态不允许此操作
EcsError ECS接口调用失败
UnknownError 未知错误

ResetNodes 批量重置计算节点

请求参数

字段 类型 是否必须 默认值 描述
Action String - 操作接口名,系统规定参数,取值:ResetNodes
RegionId String - 地域ID
ClusterId String - 集群ID
Instance.n.Id String - 第n个(n从1开始编号,可以有多条)要重置的节点实例ID

返回参数

公共参数。

错误码

Code 解释
InvalidParams 无效的参数
InvalidStatus 集群或节点状态不允许此操作
EcsError ECS接口调用失败
UnknownError 未知错误

ListNodes 查询集群中节点列表

查询指定集群的节点信息。

请求参数

字段 类型 是否必须 默认值 描述
Action String - 操作接口名,系统规定参数,取值:ListNodes
RegionId String - 地域ID
ClusterId String - 集群ID
Role String Compute 节点角色,可选项包括 Manager:管控节点,Login:跳板机,Compute:计算节点
PageNumber Integer 1 显示的页码,起始值为 1
PageSize Integer 10 每页显示的条数,1-50

返回参数

公共参数和以下参数:

字段 类型 描述
Nodes Array\ 节点信息数组
TotalCount Integer 列表条目总数
PageNumber Integer 当前页码
PageSize Integer 本页条数

其中,NodeInfo结构包含以下字段:

字段 取值 描述
Id String 节点实例ID
RegionId String 地域ID
Status String 节点状态
CreateByEhpc Boolean 是否由EHPC创建,目前都是
Role String 节点类别,’Scheduler’:主调度器,’SchedulerBackup’:备用调度器,’Account’:主域服务器,’AccountBackup’:备用域服务器,Login’:跳板机,’Compute’:计算节点。调度器和域服务器都属于管控节点(Manager)。
TotalResources ResourceType 资源总量
UsedResources ResourceType 计算节点资源使用量,其他类型节点返回值为空。
AddTime Date 加入集群时间

其中,计算节点资源 ResourceType 结构包含以下字段:

字段 取值 描述
Cpu Integer CPU资源总量,单位:核。
Memory Integer 内存资源总量,单位:GB。
Gpu Integer GPU资源总量,单位:卡。

节点状态Status的可能取值:

取值 描述
uninit 未初始化
init 初始化中
ready 空闲
running 运行中
exception 异常

错误码

Code 解释
InvalidParams 无效的参数
EcsError ECS接口调用失败
UnknownError 未知错误
本文导读目录