第 1 章 Ceph RESTful API
作为存储管理员，您可以使用 Ceph RESTful API，或者只是由 Red Hat Ceph Storage Dashboard 提供的 Ceph API，以便与 Red Hat Ceph Storage 集群交互。您可以显示有关 Ceph Monitor 和 OSD 的信息，以及它们对应的配置选项。您甚至可以创建或编辑 Ceph 池。
Ceph API 使用以下标准：
- HTTP 1.1
- JSON
- MIME 和 HTTP 内容协商
- JWT
这些标准符合 OpenAPI 3.0，符合 API 语法、语义、内容编码、版本控制、身份验证和授权。
先决条件
- 一个正常运行的 Red Hat Ceph Storage 集群。
- 访问运行 Ceph Manager 的节点。
1.1. 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响应。
使用语义版本.
- 主要变化是向后不兼容的。更改可能会导致对请求进行非附加更改，以及特定端点的响应格式。
- 次要变化是向后和向前兼容的。更改包括对特定端点的请求或响应格式的添加更改。
