Cluster相关接口

创建集群

描述

创建cluster实例

请求结构

POST /v1/cluster HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
clusterName String RequestBody参数 集群名字
version String RequestBody参数 k8s的版本
mainAvailableZone String RequestBody参数 主可用区,当用户选择多可用区的时候,其中有一个是主可用区,需要明确传给cce-service
containerNet String RequestBody参数 容器网络
advancedOptions AdvancedOptions RequestBody参数 集群高级选项配置
cdsPreMountInfo CdsPreMountInfo RequestBody参数 CDS盘预挂载信息,CdsPreMountInfo说明见附录
comment String RequestBody参数 备注
deployMode String RequestBody参数 节点类型(BCC、DCC)
dccUuid String RequestBody参数 DCC服务器UUID
masterExposed Boolean RequestBody参数 自定义master,默认是false
orderContent BaseCreateOrderRequestVo RequestBody参数 bcc创建的订单内容,T表示BCC,EIP,CDS配置模型,参考BCC config,EIP config, CDS config
masterOrderContent BaseCreateOrderRequestVo RequestBody参数 bcc创建的订单内容,T表示BCC,EIP,CDS配置模型,参考BCC config,EIP config, CDS config

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
clusterUuid String 集群id
orderId List 订单id列表

请求示例

POST /v1/cluster  HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "clusterName":"baidu_auto",
    "mainAvailableZone":"zoneA",
    "containerNet":"192.168.128.0/17",
    "version":"1.11.5",
    "deployMode":"BCC",
    "comment":"Just qa auto test.",
    "cdsPreMountInfo":{
        "mountPath":"/data",
        "cdsConfig":[
            {
                "snapshotId":"",
                "volumeType":"ssd",
                "size":50
            }
        ]
    },
    "orderContent":{
        "items":[
            {
                "config":{
                    "name":"baidu",
                    "productType":"postpay",
                    "logicalZone":"zoneA",
                    "instanceType":7,
                    "cpu":2,
                    "memory":4,
                    "imageType":"common",
                    "osType":"linux",
                    "osVersion":"7.3 x86_64 (64bit)",
                    "subnetUuid":"d1c10575-d5b8-4359-9f85-afb853eba839",
                    "securityGroupId":"g-i0nbm8pjqr4c",
                    "purchaseLength":1,
                    "purchaseNum":1,
                    "autoRenewTimeUnit":"month",
                    "autoRenewTime":0,
                    "createEphemeralList":[
                        {
                            "storageType":"ssd",
                            "sizeInGB":90,
                            "volumeType":"ssd"
                        }
                    ],
                    "autoRenew":"false",
                    "imageId":"bc30e41d-5a01-44a2-8e3e-bbf103e2284f",
                    "osName":"osname-baidu",
                    "serviceType":"BCC",
                    "adminPass":"x7!Cxx57"
                }
            },
            {
                "config":{
                    "bandwidthInMbps":100,
                    "productType":"postpay",
                    "name":"eip_name",
                    "purchaseNum":1,
                    "subProductType":"netraffic",
                    "serviceType":"EIP"
                }
            },
            {
                "config":{
                    "productType":"postpay",
                    "purchaseNum":1,
                    "cdsDiskSize":[
                        {
                            "snapshotId":"",
                            "volumeType":"ssd",
                            "size":50
                        },
                        {
                            "snapshotId":"",
                            "size":5,
                            "volumeType":"sata"
                        }
                    ],
                    "logicalZone":"zoneA",
                    "serviceType":"CDS",
                    "purchaseLength":2
                }
            }
        ]
    }
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2019 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
    "clusterUuid": "c-NqYwWEhu",
    "orderId": [
        "8d58c20f46294a7ea4922928db1fddea" 
        ]
}

注意:
虚机节点的/etc/kubernetes/pki下和/root/.kube/config下存放了集群敏感信息,请注意保管。

集群列表

描述

返回对应状态的集群详情

请求结构

GET /v1/cluster?status={status}   HTTP/1.1   
Host: cce.bj.baidubce.com      
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
marker String Query参数 批量获取列表的查询的起始位置,是一个由系统生成的字符串
maxKeys Integer Query参数 每页包含的最大数量,最大数量通常不超过1000,缺省值为1000
status String Query参数 集群状态ClusterStatus,状态间"," 分割,可以不填写,则返回所有状态

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
marker String 标记查询的起始位置
isTruncated boolean true表示后面还有数据,false表示已经是最后一页
nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现
maxKeys Integer 每页包含的最大数量
clusters List[Cluster](https://cloud.baidu.com/doc/CCE/API.html#Cluster) 集群信息列表,其中Cluster说明见附录

请求示例

GET /v1/cluster?status=CREATING  HTTP/1.1
Host: cce.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
      "marker": "-1",
      "maxKeys": 1000,
      "status":"CREATING,RUNNING,DELETING,CREATE_FAILED,ERROR"
}

返回示例

HTTP/1.1 200 OK     
x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
Date: Thu, 16 Mar 2019 06:29:48 GMT    
Content Type: application/json;charset=UTF-8     
Server: BWS    
{
"nextMarker": null,
"marker": "-1",
"maxKeys": 1000,
"isTruncated": false,
"clusters": [
   {
       "clusterUuid': "c-3hWhOIiR",
       "clusterName": "cluster_cce_test",
       "slaveVmCount": 1,
       "masterVmCount": 1,
       "containerNet": "192.168.100.0/24",
       "region": "bj",
       "status": "RUNNING",
       "createTime": "2019-07-21T11:55:46Z",
       "deleteTime": null,
       "allInstanceNormal": true,
       "instanceList":[
           {
              "instanceShortId":"i-Oivmgml6",
              "instanceUuid":"364ff3f8-ca67-4f07-9f7a-f29f60252317",
              "instanceName":"instance-s0yc0mo5",
              "status":"RUNNING",
              "clusterUuid": "c-cltgnkDb"
           } 
       ]
    }
  ]
}

集群详情

描述

集群详情

请求结构

GET /v1/cluster/{clusterUuid} HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
clusterUuid String URL参数 集群id

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
clusterUuid String 集群的uuid
clusterName String 集群的名字
version String k8s版本号
region String 所属区域
slaveVmCount Integer k8s集群从节点虚机数
masterVmCount Integer k8s集群主节点虚机数
vpcId String vpc短id
vpcUuid String vpc长id
vpcCidr String vpc CIDR地址段
zoneSubnetMap Map 可用区->subnet CIDR地址
containerNet String 容器网络
advancedOptions AdvancedOptions 集群高级配置
status ClusterStatus 集群状态
createStartTime Timestamp 集群创建时间
deleteTime Timestamp 集群删除时间
comment String 集群备注
instanceMode String 节点类型,bcc实例、dcc专属实例
hasPrepay Boolean 是否包含预付费节点
vpcName String VPC名称
secureContainerEnable Boolean 若为true,切换容器运行时为kata-container(实现容器硬隔离)
masterZoneSubnetMap Map 主节点可用区->subnet CIDR地址
masterExposed Boolean 是否自定义主节点

请求示例

GET /v1/cluster/c-3hWhOIiR HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: authorization string

返回示例

HTTP/1.1 200 OK     
x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
Date: Thu, 16 Mar 2019 06:29:48 GMT       
Content Type: application/json;charset=UTF-8     
Server: BWS               
{
    "clusterUuid": "c-n9NKMDfe",
    "clusterName": "baidu_auto",
    "version": "1.11.5",
    "region": "bj",
    "slaveVmCount": 2,
    "masterVmCount": 3,
    "vpcId": "vpc-t6d16myuuqyu",
    "vpcUuid": "2d750722-d829-4886-9a44-1472885ae37f",
    "vpcCidr": "192.168.0.0/20",
    "zoneSubnetMap": {
        "zoneA": "192.168.0.0/24"
    },
    "containerNet": "172.24.0.0/19",
    "status": "RUNNING",
    "deleteTime": "1971-01-01T00:00:01Z",
    "comment": "Just qa auto test.",
    "instanceMode": "BCC",
    "hasPrepay": false,
    "vpcName": "baidu-20",
    "secureContainerEnable": null,
    "advancedOptions": {
        "secureContainerEnable": false,
        "kubeProxyMode": "iptables",
        "setOSSecurity": false
    },
    "masterZoneSubnetMap": {},
    "masterExposed": false,
    "createTime": "2019-05-13T09:54:57Z"
}

删除集群

描述

删除cluster

请求结构

DELETE /v1/cluster/{clusterUuid} HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
clusterUuid String URL参数 集群id
authCode String Query参数 验证码
from String Query参数 删除集群是否来自console
deleteEipCds Boolean Query参数 是否联动删除eip、cds,默认值false
deleteSnap Boolean Query参数 是否联动删除快照,默认值false

返回头域

除公共头域,无其它特殊头域。

返回参数

无特殊返回参数

请求示例

DELETE /v1/cluster/1849ef6b-f73c HTTP/1.1
Host: cce.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2019 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

集群扩容

描述

为集群添加节点

请求结构

POST /v1/cluster?scalingUp=  HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
scalingUp String Query参数 对集群进行的操作,当前取值""
clusterUuid String RequestBody参数 集群id
dccUuid String RequestBody参数 DCC服务器UUID
cdsPreMountInfo CdsPreMountInfo RequestBody参数 CDS盘预挂载信息,CdsPreMountInfo说明见附录
orderContent BaseCreateOrderRequestVo RequestBody参数 bcc创建的订单内容,T表示BCC,EIP,CDS配置模型,参考BCC config,EIP config, CDS config

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
clusterUuid String 集群id
orderId List 订单id列表

请求示例

POST /v1/cluster?scalingUp=  HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "clusterUuid":"c-vNss7Lfw",
    "cdsPreMountInfo":{
        "mountPath":"/data",
        "cdsConfig":[
            {
                "snapshotId":"",
                "volumeType":"ssd",
                "size":70
            }
        ]
    },
    "orderContent":{
        "items":[
            {
                "config":{
                    "name":"baidu",
                    "productType":"postpay",
                    "logicalZone":"zoneA",
                    "instanceType":7,
                    "cpu":2,
                    "memory":4,
                    "imageType":"common",
                    "osType":"linux",
                    "osVersion":"7.3 x86_64 (64bit)",
                    "subnetUuid":"d1c10575-d5b8-4359-9f85-afb853eba839",
                    "securityGroupId":"g-i0nbm8pjqr4c",
                    "purchaseLength":1,
                    "purchaseNum":2,
                    "autoRenewTimeUnit":"month",
                    "autoRenewTime":0,
                    "createEphemeralList":[
                        {
                            "storageType":"ssd",
                            "sizeInGB":100,
                            "volumeType":"ssd"
                        }
                    ],
                    "autoRenew":"false",
                    "imageId":"bc30e41d-5a01-44a2-8e3e-bbf103e2284f",
                    "osName":"osname-baidu",
                    "serviceType":"BCC",
                    "adminPass":"x7!Cxx57"
                }
            },
            {
                "config":{
                    "bandwidthInMbps":100,
                    "productType":"postpay",
                    "name":"eip_name",
                    "purchaseNum":2,
                    "subProductType":"netraffic",
                    "serviceType":"EIP"
                }
            },
            {
                "config":{
                    "productType":"postpay",
                    "purchaseNum":2,
                    "cdsDiskSize":[
                        {
                            "snapshotId":"",
                            "volumeType":"ssd",
                            "size":70
                        },
                        {
                            "snapshotId":"",
                            "size":5,
                            "volumeType":"sata"
                        }
                    ],
                    "logicalZone":"zoneA",
                    "serviceType":"CDS"
                }
            }
        ]
    }
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2019 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
    "clusterUuid": "c-NqYwWEhu",
    "orderId": [
        "8d58c20f46294a7ea4922928db1fddea"
    ]
}

集群缩容

描述

为集群删除节点

请求结构

POST /v1/cluster?scalingDown=  HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
scalingDown String Query参数 对集群进行的操作,当前取值""
deleteEipCds Boolean Query参数 是否联动删除eip、cds,默认值false
deleteSnap Boolean Query参数 是否联动删除快照,默认值false
authCode String Query参数 短信验证码
from String Query参数 缩容请求是否来自console页面
clusterUuid String RequestBody参数 集群UUid
nodeInfo List[NodeInfo](https://cloud.baidu.com/doc/CCE/API.html#NodeInfo) RequestBody参数 删除节点信息,其中NodeInfo说明见附录

返回头域

除公共头域,无其它特殊头域。

返回参数

无返回值

请求示例

POST /v1/cluster?scalingDown=  HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "clusterUuid": "c-NqYwWEhu",
    "nodeInfo": [
        {
            "instanceId": "i-worker1"
        },
        {
            "instanceId": "i-worker2"
        }
    ]
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2019 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

节点列表

描述

请求集群节点列表

请求结构

GET /v1/node?clusterUuid={clusterUuid} HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
marker String Query参数 标记分页开始点
maxKeys Integer Query参数 一页条目数量,默认1000
clusterUuid String Query参数 集群id

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
marker String 标记查询的起始位置
isTruncated boolean true表示后面还有数据,false表示已经是最后一页
nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现
maxKeys Integer 每页包含的最大数量
nodes List[Node](https://cloud.baidu.com/doc/CCE/API.html#Node) 节点列表结果,其中Node说明见附录

请求示例

GET /v1/node?clusterUuid=c-PwLBHYuy  HTTP/1.1
Host: cce.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2019 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
    "marker": "-1",
    "isTruncated": false,
    "nextMarker": null,
    "maxKeys": 1000,
    "clusters": [
        {
            "clusterUuid": "c-DQAhSqpp",
            "clusterName": "baidu-rancher",
            "slaveVmCount": 1,
            "masterVmCount": 3,
            "containerNet": "172.16.0.0/16",
            "status": "RUNNING",
            "region": "bj",
            "deleteTime": "1971-01-01T00:00:01Z",
            "allInstanceNormal": true,
            "instanceList": [
                {
                    "instanceShortId": "i-lxvyi2o0",
                    "instanceUuid": "c55fbf06-6d8e-4b4f-92a6-3351f3abd771",
                    "instanceName": "instance-y4lsmki1-2",
                    "clusterUuid": "c-DQAhSqpp",
                    "status": "RUNNING"
                }
            ],
            "hasPrepay": false,
            "vpcId": "vpc-53ujns4xehnp",
            "instanceMode": "BCC",
            "masterExposed": false,
            "createTime": "2019-01-16T07:08:36Z"
        }
    ]
}