DescribeClusterUserKubeconfig
KubeConfig用于在客户端配置ACK集群的访问凭据,包含访问目标集群的身份和认证数据等信息。使用kubectl管理集群时,需要先通过KubeConfig来连接集群,您可以调用DescribeClusterUserKubeconfig接口查询指定集群的KubeConfig
服务地址:
华东1 金融云
输入参数
只看必填
ClusterId集群ID
PrivateIpAddress是否获取内网连接配置
请选择布尔值
TemporaryDurationMinutes临时KubeConfig有效期
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • KubeConfig 签发证书的默认有效期为 3 年。在临近过期 180 天内,您可以通过容器服务管理控制台或获取集群 KubeConfig 接口获取轮转后刷新的 KubeConfig,新 KubeConfig 证书的有效期仍为 3 年,老的 KubeConfig 凭据在证书过期前仍然有效,请您根据控制台显示或接口返回的 KubeConfig 过期时间及时获取轮转凭据。

  • 请妥善管理集群的 KubeConfig 凭据,并在无需使用凭据时及时完成吊销,避免 KubeConfig 泄露带来的数据泄露等安全风险。

请求语法

GET /k8s/{ClusterId}/user_config HTTP/1.1

路径参数

字段名称字段详情
ClusterIdstring

集群 ID。

示例值:c5b5e80b0b64a4bf6939d2d8fbbc5****

请求参数

字段名称字段详情
PrivateIpAddressboolean

是否获取内网连接配置。取值:展开详情

示例值:false
TemporaryDurationMinutesinteger<int64>

临时 KubeConfig 有效期,单位:分钟。取值范围:15(15 分钟)~4320(3 天)。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:15

返回参数

字段名称字段详情
configstring

集群的 KubeConfig。

示例值:apiVersion: v1\nclusters:\n- cluster:\n server: https://114.55.xx.xx:6443\n certificate-authority-data: LS0tLS****
expirationstring

KubeConfig 的过期时间。格式:RFC3339 格式的 UTC 时间。

示例值:2024-03-10T09:56:17Z
变更历史
暂无变更历史