Kubernetes 集群

产品文档

Kubernetes 集群

describeCluster

描述

查询单个集群详情。

请求方式

GET

请求地址

https://kubernetes.jdcloud-api.com/v1/regions/{regionId}/clusters/{clusterId}

名称 类型 是否必需 默认值 描述
regionId String True 地域 ID
clusterId String True 集群 ID

请求参数

返回参数

名称 类型 描述
result Result
requestId String

Result

名称 类型 描述
cluster Cluster

Cluster

名称 类型 描述
clusterId String 集群id
name String 名称
description String 描述
version String kubernetes的版本
azs String[ ] 集群所在的az
nodeGroups NodeGroup[ ] 节点组列表
clusterCidr String k8s的cluster的cidr
masterAuth MasterAuth 认证信息
clusterState String 状态 [pending,running,reconciling(升级时的状态), deleting, deleted, error]
stateMessage String 状态变更原因
updateTime String 更新时间
createTime String 创建时间
accessKey String 用户的AccessKey,插件调用open-api时的认证凭证
basicAuth Boolean
clientCertificate Boolean
endpoint String 用户访问的ip
endpointPort String endpoint的port
dashboardPort String endpoint的dashboard port
userMetrics Boolean 用户是否启用集群自定义监控

MasterAuth

名称 类型 描述
clusterCaCertificate String base64编码,集群的根的public certificate
clientCertificate String base64编码,客户端连接集群的public certificate
clientKey String base64编码, client的私钥
user String basic auth的user
password String basic auth的password

NodeGroup

名称 类型 描述
clusterId String 集群id
nodeGroupId String node group id
name String 名称
description String 描述
nodeConfig NodeConfig Node的信息
version String k8s中的node的版本
nodeNetwork NodeNetwork node所属的网络信息
currentCount Integer 当前node数量
expectCount Integer 期望的node数量
agId String node group的ag id ,通过agid可以查询该node group下的实例
instanceTemplateId String node group的ag id对应的实例模板
state String 状态 [pending,running,resizing,reconciling,deleting,deleted,error,running_with_error(部分节点有问题)]
updateTime String 更新时间
stateMessage String 状态变更原因
autoRepair String 是否开启自动修复
createdTime String 创建时间

NodeNetwork

名称 类型 描述
podSubnetId String pod子网的id
nodeSubnetId String node子网的id
serviceSubnetId String service子网的id
servicePublicSubnetId String service关联LB的具有公网访问能力的子网id
nodeNetworkCidr String node的cidr
vpcId String vpc id

NodeConfig

名称 类型 描述
instanceType String 实例类型
imageId String 镜像信息
systemDiskSize Integer 云盘系统盘的大小 单位(GB)
systemDiskType String 云盘系统盘的大小[ssd,premium-hdd]
labels LabelSpec[ ] Node的信息

LabelSpec

名称 类型 描述
key String key包含两个部分:prefix与name,name是必须的,prefix是可选的。prefix与name分隔用"/"。
name 可以是字母,数字,[-_.]。长度小于63。prefix:遵循DNS标准(例如:kubernetes.io/),长度不超过253
参照
value String 字母,数字,[-_.],长度不超过63

返回码

返回码 描述
200 OK
400 Invalid parameter
401 Authentication failed
404 Not found
429 Quota exceeded
500 Internal server error
503 Service unavailable
更新时间:2019-03-22 17:56:27