1.4. 客户端的 Service Registry REST API
客户端应用程序可以使用 Core Registry API v2 管理 Service Registry 中的 schema 和 API 工件。此 API 为以下功能提供操作:
- Admin
-
在
.zip
文件中导出或导入 Service Registry 数据,并在运行时管理 Service Registry 实例的日志级别。 - 工件
- 管理存储在 Service Registry 中的 schema 和 API 工件。您还可以管理工件的生命周期状态: enabled、disable 或 deprecated。
- 工件元数据
- 管理模式或 API 工件的详情。您可以编辑工件名称、描述或标签等详情。工件组等详情以及工件被创建或修改的时间为只读。
- 工件规则
- 配置规则以管理特定模式或 API 工件的内容演进,以防止将无效或不兼容的内容添加到 Service Registry 中。工件规则覆盖配置的任何全局规则。
- 工件版本
- 管理在 schema 或 API 工件被更新时创建的版本。您还可以管理工件版本的生命周期状态: enabled、disable 或 deprecated。
- 全局规则
- 配置规则以管理所有模式和 API 工件的内容演进,以防止将无效或不兼容的内容添加到 Service Registry 中。只有在工件没有配置自己的特定工件规则时,才会应用全局规则。
- 搜索
- 浏览或搜索 schema 和 API 工件和版本,例如,按名称、组、描述或标签。
- System
- 获取 Service Registry 版本以及 Service Registry 实例的资源的限制。
- 用户
- 获取当前的 Service Registry 用户。
与其他架构 registry REST API 兼容
Service Registry 通过包括其各自 REST API 的实现来提供与以下架构 registry 的兼容性:
- Service Registry Core Registry API v1
- Confluent Schema Registry API v6
- Confluent Schema Registry API v7
- CNCF CloudEvents Schema Registry API v0
使用 Confluent 客户端库的应用程序可以使用 Service Registry 作为 drop-in 替换。如需了解更多详细信息,请参阅 替换 Confluent Schema Registry。
其他资源
- 有关 Core Registry API v2 的更多信息,请参阅 Apicurio Registry REST API 文档。
-
对于 Core Registry API v2 和所有兼容 API 的 API 文档,请浏览 Service Registry 实例的
/apis
端点,例如http://MY-REGISTRY-URL/apis
。