DescribeExistedInstances（查询已经存在的云服务器）

接口描述

查询已经存在的服务器，判断是否可以加入集群。

判断条件

支持移入到集群的虚拟机需同时满足以下条件：

该实例没有加入到k8s 集群
该实例与容器集群在同一VPC下
该实例处于关机状态

请求方式

GET/POST

输入参数

参数	类型	是否必选	描述
ClusterId	String	否	集群id
InstanceId.N	String	否	云服务器id
Marker	Integer	否	分页标识，单次调用未返回全部实例时，标记下次调用的返回值的起点，默认值是0。
MaxResults	Integer	否	单次调用所返回的最大实例数目，默认10，范围(0-50]。
Filter.N	Filter.N数据类型	否	一个或者多个过滤器，有效值： vpc id：vpc-id 子网id：subnet-id 可用区：availability-zone.name 实例状态：instance-state.name
Search	String	否	模糊匹配，可匹配如下字段：服务器名称(InstanceName)、主网卡私有IP（PrivateIpAddress）。

返回参数

参数	类型	描述
RequestId	String	请求id
MaxResults	Integer	单次调用返回的最大数
Marker	Integer	分页标识，如果调用未返回全部实例，标记下次调用的返回值的起点，如果已返回全部实例，则其值为0。
TotalCount	Integer	实例数量
ExistedInstanceSet	Array of ExistedInstanceSet	存在的云服务器信息

调用示例

查询已经存在的云服务器

输入示例

http://kce.api.ksyun.com/?Action= DescribeExistedInstances&Version=2019-08-06
&ClusterId=0ffbb863-9bdc-4558-a947-xxxxxx
&InstanceId.1=ee355b5d-79e4-4505-b0a5-xxxxxx

返回示例

{
    "InstanceSet": [
        {
            "InstanceId": "ee355b5d-79e4-4505-b0a5-xxxxxx",
            "InstanceName": "xxxxxx",
            "InstanceType": "N3.2B",
            "PrivateIpAddress": "10.0.11.xxx",
            "Available": true,
            "UnavailableReason": null,
            "ClusterId": null
        }
    ],
    "TotalCount": 1,
    "MaxResults": 10,
    "Marker": 0,
    "RequestId": "0dd5d0de-cd9f-4ca9-b2c2-xxxxxx"
}

文档导读

上一篇：查询集群节点列表

下一篇：获取支持移入集群的裸金属服务器

纯净模式常规模式

纯净模式

点击可全屏预览文档内容