查询集群节点列表-API 中心-腾讯云

说明：

当前页面接口为旧版 API，未来可能停止维护。容器服务 API 3.0 版本接口定义更加规范，访问时延下降显著，建议使用容器服务 API 3.0。

接口描述

本接口 ( DescribeClusterInstances ) 用于查询集群节点，该接口返回集群内节点信息。

接口请求域名：

ccs.api.qcloud.com

输入参数

以下请求参数列表仅列出了接口请求参数，其它参数见公共请求参数。

参数名称	描述	类型	必选
clusterId	集群 ID，请填写查询集群列表接口中返回的 clusterId 字段	String	是
offset	偏移量，默认 0	Int	否
limit	最大输出条数，默认 20	Int	否
namespace	命名空间，默认为 default	String	否
instancesId	实例列表，默认为空	[]String	否

输出参数

参数名称	描述	类型
code	公共错误码。0 表示成功，其他值表示失败	Int
codeDesc	业务错误码。成功时返回 Success，错误时返回具体业务错误原因	String
message	模块错误信息描述，与接口相关	String
totalCount	集群节点总数	Int
nodes	节点列表，详细信息如下	Object Array

节点字段详细说明：

字段	描述	类型
instanceId	节点 ID	String
projectId	所属项目ID	Int
instanceName	节点名	String
instanceType	节点类型	String
kernelVersion	节点内核版本	String
podCidr	节点上的容器网段	String
cpu	节点 CPU 毫核数	Int
mem	节点上的内存 Mi 数	Int
gpu	节点上的Gpu核数	Int
wanIp	节点外网 IP	String
lanIp	节点内网 IP	String
osImage	节点镜像	String
isNormal	节点在集群中的状态，0 表示不正常，1 表示正常	Int
cvmState	节点状态，具体可以参考查看实例列表页面中的实例状态列表	Int
cvmPayMode	节点计费模式 0：按月结算的后付费 1：包年包月 2：按量计费	Int
networkPayMode	网络计费模式 0：按月结算的后付费 1：包年包月 2：按流量 3：按带宽关于各个网络计费模式之间的区别可以参考购买网络带宽	Int
createdAt	节点加入到集群的时间	String
instanceCreateTime	节点创建时间	String
instanceDeadlineTime	包年包月节点到期时间	String
zoneId	节点所在可用区 ID	Int
zone	节点所在可用区	String
abnormalReason	节点异常状态原因，可能有多个，具体见下表	String
labels	节点的Labels	String Map
autoScalingGroupId	自动伸缩组ID	String
unschedulable	节点当前是否可调度	Bool
drainStatus	节点当前驱逐状态	String

abnormalReason 参数详细说明：

异常状态类型	异常状态描述
MemoryPressure	内存不足
OutOfDisk	磁盘空间不足
NetworkUnavailable	网络配置错误
Unknown	未知的异常

示例

输入

  https://domain/v2/index.php?Action=DescribeClusterInstances
  &clusterId=cls-hd1jv48o
  &instancesId.0=ins-nt4ka2zs
  &offset=0
  &limit=20
  &namespace=default
  &其它公共参数

输出

{
    "data":{
        "code":0,
        "message":"",
        "codeDesc":"Success",
        "data":{
            "totalCount":1,
            "nodes":[
                {
                    "labels":{
                        "beta.kubernetes.io/instance-type":"QCLOUD"
                    },
                    "instanceId":"ins-k3vr10qs",
                    "instanceName":"ccs_cls-lihr85tq_node",
                    "instanceType":"CVM.S2",
                    "zoneId":100004,
                    "wanIp":"134.175.166.170",
                    "lanIp":"172.31.31.43",
                    "cpu":940,
                    "mem":604,
                    "gpu":0,
                    "kernelVersion":"4.4.0-104-generic",
                    "osImage":"Ubuntu 16.04.1 LTS",
                    "podCidr":"172.22.0.0/24",
                    "isNormal":1,
                    "abnormalReason":"",
                    "cvmState":2,
                    "cvmPayMode":2,
                    "networkPayMode":2,
                    "createdAt":"2018-07-15 12:41:37",
                    "instanceCreateTime":"2018-07-15 12:40:03",
                    "instanceDeadlineTime":"0000-00-00 00:00:00",
                    "unschedulable":false,
                    "drainStatus":"",
                    "autoScalingGroupId":"",
                    "projectId":0,
                    "zone":"ap-guangzhou-4"
                }
            ]
        }
    },
    "message":"",
    "code":0
}

查询集群节点列表

本页目录：

接口描述

输入参数

输出参数

示例

输入

输出