检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用ucs-ctl命令行工具管理本地集群 ucs-ctl是管理UCS本地集群的命令行工具，它仅适用于UCS本地集群。 在使用ucs-ctl工具前，为防止您执行被篡改的ucs-ctl工具，请先进行工具的完整性校验，具体操作请参考安装及验证章节的ucs-ctl工具完整性校验操作步骤。
查询联邦开启进度 功能介绍 查询联邦开启进度 URI GET /v1/clustergroups/{clustergroupid}/federations/progress 表1 路径参数 参数 是否必选 参数类型 描述 clustergroupid 是 String 容器舰队id
获取租户的CCE集群列表 功能介绍 获取当前租户的CCE集群列表 URI GET /v1/managedclusters 表1 Query参数 参数 是否必选 参数类型 描述 unregister 否 Boolean 是否注册到ucs 请求参数 表2 请求Header参数 参数 是否必选
查询支持接入UCS的集群版本列表 功能介绍 查询支持接入UCS的集群版本列表 URI GET /v1/config/registeredclusterversions 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String
注册容器舰队 功能介绍 容器舰队创建API，生成容器舰队时可以选择关联的集群 URI POST /v1/clustergroups 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 身份认证信息 最小长度：1 最大长度：16384
安装前准备（私网接入） 本小节指导您进行本地集群的安装前准备。在选择私网接入集群时，才需执行安装前准备。选择“公网接入”时，可直接执行安装及验证。 本地集群的安装前准备包括创建虚拟私有云并与线下IDC网络环境打通、创建终端节点并将其配置在VPC中的DNS服务器中。 部署网络环境
创建联邦网络连接 功能介绍 舰队开通联邦后，创建vpcep终端节点连接到联邦apiserver URI POST /v1/clustergroups/{clustergroupid}/connection 表1 路径参数 参数 是否必选 参数类型 描述 clustergroupid
获取单个集群 功能介绍 获取集群信息。传入的cluster ID必须符合k8s UUID的格式规则；同时需要用户有对应集群的获取权限，否则会鉴权失败 URI GET /v1/clusters/{clusterid} 表1 路径参数 参数 是否必选 参数类型 描述 clusterid
下载联邦kubeconfig 功能介绍 舰队开通联邦并且创建网络连接之后，可以使用此接口下载联邦的kubeconfig URI POST /v1/clustergroups/{clustergroupid}/kubeconfig 表1 路径参数 参数 是否必选 参数类型 描述 clustergroupid
注册集群 功能介绍 集群注册接口。支持三方集群的注册和CCE导入集群的注册。 URI POST /v1/clusters 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 身份认证信息 最小长度：1 最大长度：16384
创建联邦网络连接并下载联邦kubeconfig 功能介绍 舰队开通联邦后，调用此接口，创建vpcep终端节点，连接到联邦apiserver，并下载联邦apiserver的kubeconfig URI POST /v1/clustergroups/{clustergroupid}/cert
创建配置集合 背景 Podinfo是一个微模型的Web应用程序，它展示了在Kubernetes中运行微服务的最佳实践，其主要用作于测试和研讨。本章将用podinfo源代码来做创建配置集合的示例。 为了可以更快的、更稳定的持续地交付软件、减少后续维护工作，所以将podinfo的源代
安装本地集群 安装前检查 安装前准备（私网接入） 安装及验证 父主题： 本地集群
获取集群接入信息 功能介绍 该API接口用于获取集群接入信息；传入的cluster ID必须符合k8s UUID的格式规则；同时需要用户有对应集群证书的获取权限，否则会鉴权失败；agent证书只可以下载一次。仅用于获取三方集群的集群接入信息，CCE集群不从该接口获取，如果传入CCE集群ID，返回码为400
集群中Kubernetes资源权限（RBAC授权） 集群中Kubernetes资源权限是基于Kubernetes RBAC能力的授权，管理员可授予用户针对集群内特定Kubernetes资源对象的操作权限，权限最终作用在舰队或未加入舰队的集群的命名空间上。 本章节以“只读权限”为例
如何精细化管理集群联邦权限？ 如果您在访问联邦资源时出现如下错误提示，说明您没有对应资源的操作权限，请您向您的管理员申请授予对应的权限，创建对应的Role/RoleBinding或者ClusterRole/ClusterRolebinding权限。 如果出现“no such host”问题，请按以下步骤进行排查：
错误码 如果操作请求在执行过程中出现异常导致未被处理，则会返回一条错误信息。错误信息中包括错误码和具体错误描述，表1列出了错误信息中的常见错误码及错误信息，您可根据描述处理相应的异常。 表1 错误码说明 错误码 状态码 错误信息 描述 UCS.00000001 400 Failed
通过MCI实现跨集群业务流量分发 应用场景 在分布式集群场景下，为了提供低延迟的服务，企业的应用可能部署在不同区域、不同厂商的云端上，在某个地区集群发生故障时，该地区业务也随之会受到影响。使用MCI，可进行跨地域集群的流量分发，实现跨地域的应用故障迁移。 图1 MCI实现跨集群流量分发架构图
使用对等连接打通CCE集群网络 应用场景 在创建MCS对象前，需要保证集群间网络互通。其中，跨VPC的CCE集群间网络可以通过创建对等连接的方式打通。 本文将介绍如何通过创建对等连接的方式，为跨VPC的CCE集群打通节点间与容器间网络。 设置集群网络类型 将集群的网络类型设置为u
附录 状态码 错误码 获取项目ID 获取账号ID 国家码 城市码 集群类别与类型说明
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
