检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何添加第三方域名？ 问题描述 域名在第三方域名注册商处注册，需要使用UCS进行流量管理，此时可通过添加域名至华为云云解析服务（DNS）来解决，UCS流量管理控制台将自动获取已添加解析的域名。 步骤一：添加域名 通过第三方域名注册商注册的域名，需要通过“创建公网域名”操作添加至云解析服务。
向比例。 配置域名 为应用添加域名访问时，必须确保您配置的域名已在域名服务商完成注册并备案，否则域名可能无法访问。 若您已有经过注册和备案的域名，请直接至3创建公网域名解析。 若您尚未注册域名，请先购买公网域名，并按照页面提示流程完成域名的备案、解析和相关配置。域名注册、备案流程如下。
如何调用API 构造请求 认证鉴权 返回结果
终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点查询服务的终端节点。 UCS的终端节点如下表所示，请您根据业务需要选择对应区域的终端节点。 表1 UCS的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四
API UCS集群 容器舰队 权限管理
获取集群接入信息 功能介绍 该API接口用于获取集群接入信息；传入的cluster ID必须符合k8s UUID的格式规则；同时需要用户有对应集群证书的获取权限，否则会鉴权失败；agent证书只可以下载一次。仅用于获取三方集群的集群接入信息，CCE集群不从该接口获取，如果传入CCE集群ID，返回码为400
注册集群 功能介绍 集群注册接口。支持三方集群的注册和CCE导入集群的注册。 URI POST /v1/clusters 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 身份认证信息 最小长度：1 最大长度：16384
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说
除各类联邦资源。了解详细的Karmada API信息请参见Karmada API。 UCS支持通过API网关调用Karmada API。 通过API网关调用Karmada API Karmada API 可以通过API网关调用，其URL格式为：https://{fleetname}
单个字符串不超过63个字符，域名总长度不超过254个字符。 如果没有子域名，域名前缀部分可不填。 域名后缀部分为云解析服务（DNS）中已添加解析的公网域名。如您需要管理域名，请前往DNS控制台，具体步骤请参见公网域名管理。 调度策略：可基于访问位置和业务策略对流量进行调度，详见4。
约束与限制 本地集群支持使用华为云IAM Token访问Kube APIServer；同时，不对UCS的系统策略（UCS FullAccess、UCS CommonOperations、UCS CIAOperations和UCS ReadOnlyAccess）进行识别。 对于多云集群
对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。
某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scop
流量分发功能基于云解析服务为用户的域名提供流量治理功能。当用户需要使用域名访问集群时，首先需要前往云解析服务（DNS）为域名添加解析服务。 DNS支持为华为云注册的域名和第三方注册的域名添加解析，配置方法请参见快速添加网站域名解析。 您需要前往域名注册商处完成域名的注册。 如果您的域名在中国大陆地区注册，需要完成域名的实名认证审核。
117:80/helloworld），此请求将被转发到对应的目标Service处理。您可添加多条转发策略。 域名：可选项，输入实际访问的域名地址。请确保所填写的域名已注册并备案，一旦配置了域名规则后，必须使用域名访问。 URL：需要注册的访问路径，例如：/healthz。该访问路径需与后端应用暴露的URL一致，否则将返回404错误。
表3 请求Body参数 参数 是否必选 参数类型 描述 dnsSuffix 否 Array of strings 在联邦管理的域名访问功能中，用于更改根域名 响应参数 无 请求示例 更新容器舰队的联邦对应的zone POST https://ucs.myhuaweicloud.co
删除集群 功能介绍 用于集群解除注册；传入的cluster ID必须符合k8s UUID的格式规则；同时需要用户有对应集群的操作权限，否则会鉴权失败。 URI DELETE /v1/clusters/{clusterid} 表1 路径参数 参数 是否必选 参数类型 描述 clusterid
{联邦控制面地址域名}，可解析到联邦控制面的IP地址，如下图： coredns-detect-period CoreDNS进行探测和上报的周期，默认5s（推荐值）。周期越短，探测和上报越频繁。 coredns-success-threshold CoreDNS域名解析成功持续时长
激活集群 功能介绍 激活集群接口；传入的cluster ID必须符合k8s UUID的格式规则；同时需要用户有对应集群的更新权限，否则会鉴权失败 URI PUT /v1/clusters/{clusterid}/activation 表1 路径参数 参数 是否必选 参数类型 描述
删除容器舰队 功能介绍 容器舰队删除接口，只有在容器舰队为空时才可以删除该容器舰队，若需删除请先将集群移出容器舰队；传入的cluster ID必须符合k8s UUID的格式规则；同时需要用户有对应集群的操作权限，否则会鉴权失败 URI DELETE /v1/clustergroups/{clustergroupid}
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
