查询节点池详情

DescribeNodePool（查询节点池详情）

接口描述

该接口适用于用户查询节点池详情

请求方式

GET

输入参数

参数	类型	是否必选	描述
ClusterId	String	是	集群id
NodePoolId.N	String	否	节点池id
Marker	Integer	否	分页标识，单次调用未返回全部实例时，标记下次调用的返回值的起点，默认值是0
MaxResults	Integer	否	单次调用所返回的最大实例数目，默认10， 范围(0-50]

返回参数

参数	类型	描述
RequestId	String	请求id
MaxResults	Integer	单次调用返回的最大数
Marker	Integer	分页标识，如果调用未返回全部实例，标记下次调用的返回值的起点，如果已返回全部实例，则其值为0
TotalCount	Integer	节点池数量
NodePoolSet	Array of NodePool	节点池详细信息
ScaleUpPolicy	String	集群扩容算法
ScaleDownPolicy	ScaleDownPolicy数据类型	集群缩容算法

NodePool

参数	类型	描述
NodePoolId	String	节点池id
NodePoolName	String	节点池名称
Status	String	节点池状态，有效值： - updating：伸缩中 - normal：启用 - error：异常
EnableAutoScale	Boolean	是否开启弹性伸缩，有效值： - True：开启弹性伸缩 - False：关闭弹性伸缩
NodeTemplate	NodeTemplate数据类型	节点模板信息
Label	Array of Label	节点标签
Taint	Array of Taint	节点污点
MinSize	Integer	最小节点数量，即为最小能缩容的实例数量
MaxSize	Integer	最大节点数量，即为最大能扩容的实例数量
DesiredCapacity	Integer	当前期望节点数量
InstanceCount	Integer	当前实例数量

ScaleDownPolicy

参数	类型	描述
ScaleDownEnabled	Boolean	是否启用自动缩容
ScaleDownDelayAfterAdd	Integer	集群扩容后多少分钟开始考虑缩容条件
ScaleDownUnneededTime	Integer	节点满足缩容条件多少分钟后开始启动缩容
ScaleDownUtilizationThreshold	Integer	缩容阈值百分比。Node已分配资源/node可分配资源小于多少（百分比）时，开始判断缩容条件
MaxEmptyBulkDelete	Integer	缩容最大并发数

调用示例

查询节点池详情

输入示例

http://kce.api.ksyun.com/?Action=DescribeNodePool&Version=2019-08-06
&ClusterId=b9a92bf7-3092-4623-a201-xxxxx
&NodePoolId.1=xxxxxxxxxx

返回示例

{
    "RequestId": "7a62c49f-347e-4fc4-9331-6e8e",
    "MaxResults": 10,
    "Marker": 0,
    "TotalCount": 2,
    "NodePoolSet": [
        {
            "ClusterId": "b9a92bf7-3092-4623-a201-xxxxx",
            "NodePoolId": "xxxxxxxxxx",
            "NodePoolName": "xxxxxxxxxx",
            "Status": "normal",
            "EnableAutoScale": true,
            "NodeTemplate": {
                "ScalingConfigurationId": "xxxxxxxxxx",
                "ScalingConfigurationName": "xxxxxxxxxx",
                "InstanceType": "E1.1A",
                "Cpu": "1",
                "Mem": "1",
                "ChargeType": "HourlyInstantSettlement",
                "InstanceName": "xxxxxxxxxx",
                "InstanceNameSuffix": 0,
                "DataDiskGb": 0,
                "SystemDisk": {
                    "DiskType": "Local_SSD",
                    "DiskSize": 20
                },
                "DataDisk": {
                    "DiskType": null,
                    "DiskSize": null,
                    "DeleteWithInstance": null
                },
                "ImageId": "3c504d3e-babf-4a40-85bd-xxxxxxxxxx",
                "VpcId": "15552848-026b-4ad6-a3e3-xxxxxxxxxx",
                "SubnetIdSet": [
                    "d219ceb2-a69e-4089-ab8e-xxxxxxxxxx"
                ],
                "SubnetStrategy": "balanced-distribution",
                "SecurityGroupId": "f16a009c-2de6-49d7-89f0-xxxxxxxxxx",
                "ProjectId": xxxxxxxxxx,
                "Password": null,
                "KeyIdSet": [],
                "ProductGroup": null,
                "RemovePolicy": "RemoveNewestInstance",
                "AdvancedSetting": {
                    "DataDisk": {
                        "AutoFormatAndMount": false,
                        "FileSystem": null,
                        "MountTarget": null
                    },
                    "PreUserScript": null,
                    "UserScript": null,
                    "Schedulable": null,
                    "Label": null,
                    "Taints": null,
                    "ExtraArg": null,
                    "DockerPath": null
                }
            },
            "Labels": [],
            "Taints": null,
            "MaxSize": 3,
            "MinSize": 1,
            "DesiredCapacity": 1,
            "InstanceCount": 1,
            "CreateTime": "xxxxxxxxxx"
        }
    ],
    "ScaleUpPolicy": "random",
    "ScaleDownPolicy": {
        "ScaleDownEnabled": false,
        "ScaleDownDelayAfterAdd": 10,
        "ScaleDownUnneededTime": 10,
        "ScaleDownUtilizationThreshold": 50,
        "MaxEmptyBulkDelete": 10
    }
}