注册配置治理简介

欢迎使用注册配置治理 API（以下简称注册配置治理 API）。

腾讯云注册配置治理提供弹性、高效、稳定的注册配置中心、服务治理、云原生网关能力。基于北极星（Polaris）、ZooKeeper、Nacos 等开源组件，提供微服务注册发现、配置管理、服务治理、云原生 API 网关等全栈微服务解决方案，帮助用户快速构建和管理微服务架构。

注册配置治理向用户提供以下核心能力：

用户可以使用本文档介绍的 API，并参照相应的示例，对注册配置治理进行相关操作：如创建网关实例、管理服务配置、配置服务路由等；支持的全部操作可参见 API 概览。

请确保在使用这些接口前，已充分了解了注册配置治理产品概述。

注意：

本章节注册配置治理 API 接口均为最新 API 3.0 接口，后续相关新增功能都会在此章节更新。我们强烈推荐您使用最新 API 3.0 接口。

现有旧版 API 接口功能依然保持，未来可能停止维护，如您仍需使用旧版接口可参考相关文档。

术语表

本文档涉及的一些常用术语如下：

术语	英文	说明
云原生网关	Cloud Native API Gateway	基于 Kong 的高性能 API 网关，提供路由、负载均衡、认证鉴权、限流熔断等能力。
网关实例	Gateway Instance	云原生网关的运行实例，包含节点、网络和配置信息。
服务	Service	网关中定义的后端服务，包含服务来源和 Upstream 配置。
路由	Route	定义请求转发规则，将特定路径的请求转发到目标服务。
命名空间	Namespace	北极星中用于隔离和管理服务的逻辑单元。
服务（北极星）	Service (Polaris)	北极星中注册的服务实例，包含服务名、实例列表和元数据。
服务实例	Service Instance	服务的具体运行实例，包含 IP、端口和健康状况。
配置文件	Configuration File	配置中心管理的配置文件，支持版本管理和动态下发。
配置组	Configuration Group	配置文件的分类管理单元，用于组织和管理相关配置文件。
泳道	Lane	全链路灰度发布中的流量隔离单元，确保灰度流量在灰度环境中流转。
微服务引擎	Microservice Engine	托管的 Nacos、ZooKeeper、Consul 等微服务基础设施。

用来控制分页的参数。Limit 为单次返回的最多条目数量，Offset 为偏移量。当相应结果是列表形式时，如果数量超过了 Limit 所限定的值，那么只返回 Limit 个值。

举例来说，参数 Offset=0&Limit=20 返回第 0 到 19 项，Offset=20&Limit=20 返回第 20 到 39 项，Offset=40&Limit=20 返回第 40 到 59 项；以此类推。

同时输入多个参数的格式。当遇到形如这样的格式时，那么该输入参数可以同时传多个。例如：

GET 请求或者 POST x-www-form-urlencoded 请求：Ids.0=gateway-xxxx&Ids.1=gateway-yyyy

以此类推（以下标 0 开始）。

POST json 请求：{"Ids": ["gateway-xxxx", "gateway-yyyy"]}

这里针对几个典型的使用场景对注册配置治理 API 的使用方式进行说明：