Versionierung für die Ceph-API
Das Hauptziel der Ceph-REST-konformen API ist die Bereitstellung einer stabilen Schnittstelle, die durch Versionierung erreicht wird.
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+jsonBeispiel
Accept: application/vnd.ceph.api.v1.0+jsonWenn 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.