![[17.0.0.1 以及更新版本]](../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"
]
}
]
}