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 の応答が返されます。

  • セマンティックバージョニングの使用。

    • 主な変更点は後方互換性がありません。変更すると、リクエストに無関係な変更や、特定のエンドポイントの応答形式に変更が加えられる可能性があります。
    • マイナーな変更は、後方互換性および転送の後方的です。変更は、特定のエンドポイントの要求形式または応答形式への追加変更で設定されます。