获取集群接入信息 - ShowClusterAccessInfo

功能介绍

该API接口用于获取集群接入信息；传入的cluster ID必须符合k8s UUID的格式规则；同时需要用户有对应集群证书的获取权限，否则会鉴权失败；agent证书只可以下载一次。仅用于获取附着集群的集群接入信息，CCE集群不从该接口获取，如果传入CCE集群ID，返回码为400

授权信息

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

URI

GET /v1/clusters/{clusterid}/accessinfo

表1 路径参数
参数	是否必选	参数类型	描述
clusterid	是	String	集群ID

表2 Query参数
参数	是否必选	参数类型	描述
vpcendpoint	否	String	VPC终端节点的IP地址。私网接入的集群必填，且必须是打通线下集群的VPC终端节点。创建VPC终端节点及查询IP地址的方法请参见创建终端节点。
region	否	String	接入region，私网接入的集群必填

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
[数组元素]	Array of strings	-

状态码：400

表5 响应Body参数
参数	参数类型	描述
-	String	-

状态码：403

表6 响应Body参数
参数	参数类型	描述
-	String	-

状态码：410

表7 响应Body参数
参数	参数类型	描述
-	String	-

状态码：500

表8 响应Body参数
参数	参数类型	描述
-	String	-

请求示例

无

响应示例

状态码：200

返回集群接入信息

[ {
  "apiVersion" : "apps/v1",
  "kind" : "Deployment",
  "metadata" : {
    "labels" : {
      "app" : "proxy-agent"
    },
    "name" : "proxy-agent",
    "namespace" : "kube-system"
  },
  "spec" : {
    "replicas" : 2,
    "template" : {
      "metadata" : {
        "labels" : {
          "app" : "proxy-agent"
        }
      },
      "spec" : {
        "tolerations" : [ {
          "key" : "role",
          "operator" : "Equal",
          "value" : "manage"
        } ],
        "containers" : [ {
          "command" : [ "/proxy-agent" ],
          "args" : [ "--logtostderr=true", "--ca-cert=/var/certs/agent/ca.crt", "--agent-cert=/var/certs/agent/proxy-agent.crt", "--agent-key=/var/certs/agent/proxy-agent.key", "--proxy-server-host=proxyurl.ucs.myhuaweicloud.com", "--proxy-server-port=30123", "--agent-id={uuid}", "--agent-identifiers=host={ip_addr}" ],
          "image" : "{image_addr}",
          "imagePullPolicy" : "IfNotPresent",
          "name" : "proxy-agent"
        } ],
        "priorityClassName" : "system-cluster-critical",
        "hostAliases" : [ {
          "ip" : "{ip_addr}",
          "hostnames" : [ "proxyurl.ucs.myhuaweicloud.com" ]
        } ]
      }
    }
  }
}, {
  "apiVersion" : "v1",
  "kind" : "Secret",
  "metadata" : {
    "name" : "proxy-agent-cert",
    "namespace" : "kube-system"
  },
  "type" : "Opaque",
  "data" : {
    "ca.crt" : "{ca crt}",
    "proxy-agent.crt" : "{proxy-agent crt}",
    "proxy-agent.key" : "{proxy-agent key}",
    "common_shared.key" : "{common_shared key}",
    "root.key" : "{root key}"
  }
} ]

状态码

状态码	描述
200	返回集群接入信息
400	客户端请求错误，服务器无法执行请求
403	服务器拒绝执行请求
410	证书已下载
500	服务器内部错误