文档首页/ 华为云UCS/ API参考/ API/ 容器舰队/ 下载联邦kubeconfig
更新时间:2025-10-09 GMT+08:00
分享

下载联邦kubeconfig

功能介绍

舰队开通联邦并且创建网络连接之后,可以使用此接口下载联邦的kubeconfig

URI

POST /v1/clustergroups/{clustergroupid}/kubeconfig

表1 路径参数

参数

是否必选

参数类型

描述

clustergroupid

String

舰队id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

身份认证信息

表3 请求Body参数

参数

是否必选

参数类型

描述

duration

Integer

kubeconfig中证书的有效期

最小值:1

最大值:1825

响应参数

状态码:201

表4 响应Body参数

参数

参数类型

描述

kind

String

API类型,固定值“Config”,该值不可修改

apiVersion

String

API版本,固定值“v1”,该值不可修改

clusters

Array of NamedCluster objects

集群列表

users

Array of NamedAuthInfo objects

存放了指定用户的一些证书信息和ClientKey信息

contexts

Array of NamedContext objects

上下文列表

current-context

String

当前上下文

表5 NamedCluster

参数

参数类型

描述

name

String

集群名称

cluster

ClusterCert object

集群信息

表6 ClusterCert

参数

参数类型

描述

server

String

服务器地址

certificate-authority-data

String

证书授权数据

insecure-skip-tls-verify

String

不校验服务端证书

表7 NamedAuthInfo

参数

参数类型

描述

name

String

用户名

user

AuthInfo object

存放了指定用户的一些证书信息和ClientKey信息

表8 AuthInfo

参数

参数类型

描述

client-certificate-data

String

客户端证书

client-key-data

String

包含来自TLS客户端密钥文件的PEM编码数据

token

String

身份验证令牌

表9 NamedContext

参数

参数类型

描述

name

String

上下文的名称

context

String

上下文信息

请求示例

下载联邦kubeconfig

POST https://ucs.myhuaweicloud.com/v1/clustergroups/{clustergroupid}/kubeconfig

{
  "duration" : 30
}

响应示例

状态码:201

kubeconfig文件

{
  "kind" : "Config",
  "apiVersion" : "v1",
  "clusters" : [ {
    "name" : "cluster-demo",
    "cluster" : {
      "server" : "https://ip:port",
      "certificate-authority-data" : ""
    }
  } ],
  "users" : [ {
    "name" : "user",
    "user" : {
      "client-certificate-data" : "",
      "client-key-data" : "",
      "token" : ""
    }
  } ],
  "contexts" : [ {
    "name" : "demo",
    "context" : {
      "cluster" : "cluster-demo",
      "user" : "user"
    }
  } ],
  "current-context" : "demo"
}

状态码

状态码

描述

201

kubeconfig文件

错误码

请参见错误码

相关文档