查询已经存在的云服务器

最近更新时间:2020-11-02 20:43:28

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"
}

金山云,开启您的云计算之旅

免费注册