![[17.0.0.1 and later]](../ng_v17001plus.gif)
列出集合体中所有公共 RESTful API
使用集合体服务查询,发现有关整个集合体中所有公共 RESTful API(服务)的 API 文档。此查询以列表格式提供文档。
此列表包含每个服务的摘要,例如,服务的名称、版本、描述和当前部署此服务的主机列表。此列表实时更新,向集合体成员添加服务或从其中移除服务时会更改。此列表包含来自任何集合体成员的服务,不管成员是 Liberty、Docker 和 Liberty、LoopBack® 还是 Docker 和 LoopBack 服务器都会包含在内。
集合体服务查询的缺省 URL 为 http://controller_host:controller_http_port/api/collective/registry。
开始之前
/api/collective/registry API 在 Liberty API 发现功能部件中。要查询集合体中公共服务,必须首先将 apiDiscovery-1.0 功能部件添加到集合体控制器 server.xml 文件,然后在 Liberty REST 端点中公开 Swagger 2.0 文档。 完成在 Liberty 服务器上发现 REST API 文档中过程的步骤 1 和步骤 2。
过程
结果
查询提供公共服务的列表:
{
"services":[
{
"service":"/airlines/booking",
"title":"Booking REST APIs",
"description":"A microservice exposing booking APIs for various airlines.",
"version":"1.0.0",
"hosts":[
"vm001:9081",
"vm002:9082"
]
},
{
"service":"/flight/status",
"title":"Flight Status REST APIs",
"description":"A microservice exposing flight status APIs for various airports.",
"version":"1.0.1",
"hosts":[
"vm003:9085"
]
},
{
"service":"/tourism",
"title":"Tourism REST APIs",
"description":"A microservice exposing tourism information for various popular destinations.",
"version":"2.0.0",
"hosts":[
"vm004:9443"
]
}
]
}