文档首页/ 华为云UCS/ API参考/ API/ 容器舰队/ 下载联邦kubeconfig - DownloadFederationKubeconfig
更新时间：2025-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

下载联邦kubeconfig - DownloadFederationKubeconfig

功能介绍

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/clustergroups/{clustergroupid}/kubeconfig

表1 路径参数

参数

是否必选

参数类型

描述

clustergroupid

是

String

舰队id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

身份认证信息
表3 请求Body参数

参数

是否必选

参数类型

描述

duration

是

Integer

kubeconfig中证书的有效期

响应参数

状态码：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文件

错误码

请参见错误码。

父主题： 容器舰队

相关文档