Versionierung für die Ceph-API

Das Hauptziel der Ceph-REST-konformen API ist die Bereitstellung einer stabilen Schnittstelle, die durch Versionierung erreicht wird.

Um eine stabile Schnittstelle zu erreichen, basiert die Ceph-API auf den folgenden Prinzipien:
  • Eine obligatorische explizite Standardversion für alle Endpunkte, um implizite Standardwerte zu vermeiden

  • Differenzierte Änderungssteuerung pro Endpunkt.

    • Die erwartete Version von einem bestimmten Endpunkt wird im HTTP -Header angegeben.

      Syntax

      Accept: application/vnd.ceph.api.vMAJOR.MINOR+json

      Beispiel

      Accept: application/vnd.ceph.api.v1.0+json

      Wenn der aktuelle Ceph API-Server diese bestimmte Version nicht adressieren kann, wird eine 415 - Unsupported Media Type -Antwort zurückgegeben.

  • Semantische Versionierung verwenden.

    • Wichtige Änderungen sind rückwärts nicht kompatibel. Änderungen können zu nicht additiven Änderungen an der Anforderung und an den Antwortformaten für einen bestimmten Endpunkt führen.

    • Geringfügige Änderungen sind rückwärts und vorwärts kompatibel. Änderungen bestehen aus kumulativen Änderungen an den Anforderungs-oder Antwortformaten für einen bestimmten Endpunkt.