1.2. Ceph API 的版本
Ceph RESTful API 的主要目标是提供稳定的接口。要实现稳定接口,基于以下原则构建 Ceph API:
- 所有端点都有一个强制的显式默认版本,以避免隐式默认值。
精细更改每个端点的控制。
HTTP 标头中声明了特定端点的预期版本。
语法
Accept: application/vnd.ceph.api.vMAJOR.MINOR+json
示例
Accept: application/vnd.ceph.api.v1.0+json
如果当前的 Ceph API 服务器无法解决该特定版本,则将返回
415 - Unsupported Media Type
响应。
使用语义版本.
- 主要变化是向后不兼容的。更改可能会导致对请求进行非添加的更改,以及特定端点的响应格式。
- 次要变化是向后和向前兼容的。更改由特定端点的请求或响应格式的添加更改组成。