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

创建联邦网络连接并下载联邦kubeconfig

功能介绍

舰队开通联邦后,调用此接口,创建vpcep终端节点,连接到联邦apiserver,并下载联邦apiserver的kubeconfig

URI

POST /v1/clustergroups/{clustergroupid}/cert

表1 路径参数

参数

是否必选

参数类型

描述

clustergroupid

String

舰队ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

身份认证信息

表3 请求Body参数

参数

是否必选

参数类型

描述

projectID

String

项目id

vpcID

String

VPC id,必须属于上述项目

subnetID

String

子网id,必须属于上述vpc

duration

Integer

kubeconfg证书有效期,单位为天

最小值: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}/cert

{
  "projectID" : "08d44be1ef00d22e2f6fc0061f54a2f1",
  "vpcID" : "11c9fe72-5a90-4295-bcfe-774726fb9066",
  "subnetID" : "0de91d89-1e06-4e24-b371-35d5d3d3779b",
  "duration" : 30
}

响应示例

状态码:201

kubeconfig文件

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

状态码

状态码

描述

201

kubeconfig文件

错误码

请参见错误码

相关文档