Feature #40907: mgr/dashboard: REST API improvements
mgr/dashboard: REST API Docs state that the API is un-official and non-stable
Despite one the goals for Octopus was to declare Dashboard REST API as: the official & stable Ceph Management REST API, the Docs page still states:
"Please note that this API is not an official Ceph REST API to be used by third-party applications. It's primary purpose is to serve the requirements of the Ceph Dashboard and is subject to change at any time. Use at your own risk."
#2 Updated by Patrick Seidensal over 2 years ago
Maybe something like that?
Ceph Dashboard is on the way to become the official REST API. Currently, we cannot guarantee that the API will not change, but we're working on a guarantee, that he API will, wihtin once Ceph release cycle, not introduce any breaking changes. This will be the next step towards becoming the official REST API. That said, currently Ceph Dashboard has the most comprehensive API to manage a Ceph Cluster.
#3 Updated by Ernesto Puerta over 2 years ago
- add "stable" or "unstable" tags: to identify which subsets of the API are stable, or even better, which ones are considered subject to changed
- add "last-changed-in" tag: to indicate from which Ceph release every API call remains unchanged (this could help us fight the fear to commit maintaining something that we think is mostly unstable while it could be the opposite).