华为云UCS
华为云UCS
- 最新动态
- 服务公告
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- UCS集群
- 容器舰队
- 集群联邦
- 镜像仓库
- 权限管理
-
策略中心
- 策略中心概述
- 策略定义与策略实例的基本概念
- 启用策略中心
- 创建和管理策略实例
- 示例:使用策略中心实现Kubernetes资源合规性治理
-
使用策略定义库
- 策略定义库概述
- k8spspvolumetypes
- k8spspallowedusers
- k8spspselinuxv2
- k8spspseccomp
- k8spspreadonlyrootfilesystem
- k8spspprocmount
- k8spspprivilegedcontainer
- k8spsphostnetworkingports
- k8spsphostnamespace
- k8spsphostfilesystem
- k8spspfsgroup
- k8spspforbiddensysctls
- k8spspflexvolumes
- k8spspcapabilities
- k8spspapparmor
- k8spspallowprivilegeescalationcontainer
- k8srequiredprobes
- k8srequiredlabels
- k8srequiredannotations
- k8sreplicalimits
- noupdateserviceaccount
- k8simagedigests
- k8sexternalips
- k8sdisallowedtags
- k8sdisallowanonymous
- k8srequiredresources
- k8scontainerratios
- k8scontainerrequests
- k8scontainerlimits
- k8sblockwildcardingress
- k8sblocknodeport
- k8sblockloadbalancer
- k8sblockendpointeditdefaultrole
- k8spspautomountserviceaccounttokenpod
- k8sallowedrepos
- 配置管理
- 服务网格
- 流量分发
- 可观测性
- 容器迁移
- 流水线
- 错误码
- 最佳实践
- API参考
- 常见问题
- 通用参考
链接复制成功!
获取集群接入信息
功能介绍
该API接口用于获取集群接入信息;传入的cluster ID必须符合k8s UUID的格式规则;同时需要用户有对应集群证书的获取权限,否则会鉴权失败;agent证书只可以下载一次。仅用于获取三方集群的集群接入信息,CCE集群不从该接口获取,如果传入CCE集群ID,返回码为400
URI
GET /v1/clusters/{clusterid}/accessinfo
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
clusterid |
是 |
String |
集群ID |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
vpcendpoint |
否 |
String |
VPC终端节点的IP地址。私网接入的集群必填,且必须是打通线下集群的VPC终端节点。 创建VPC终端节点及查询IP地址的方法请参见创建终端节点。 |
region |
否 |
String |
接入region,私网接入的集群必填 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
身份认证信息 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
[数组元素] |
Array of strings |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
- |
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 |
服务器拒绝执行请求 |
500 |
服务器内部错误 |
错误码
请参见错误码。
父主题: UCS集群