Mandantenmanagement-API-Versionierung
Änderungen vorschlagen
PDFs
Die Mandanten-Management-API verwendet Versionierung zur Unterstützung unterbrechungsfreier Upgrades.
Diese Anforderungs-URL gibt beispielsweise Version 3 der API an.
https://hostname_or_ip_address/api/v3/authorize
Die Hauptversion der Mandantenmanagement-API wird angestoßen, wenn Änderungen vorgenommen werden, die mit älteren Versionen nicht kompatibel sind. Die Nebenversion der Mandantenmanagement-API wird angestoßen, wenn Änderungen vorgenommen werden, dass kompatibel mit älteren Versionen sind. Zu den kompatiblen Änderungen gehört das Hinzufügen neuer Endpunkte oder neuer Eigenschaften. Das folgende Beispiel zeigt, wie die API-Version basierend auf dem Typ der vorgenommenen Änderungen angestoßen wird.
| Typ der Änderung in API | Alte Version | Neue Version |
|---|---|---|
Kompatibel mit älteren Versionen |
2.1 |
2.2 |
Nicht kompatibel mit älteren Versionen |
2.1 |
3.0 |
Wenn die StorageGRID-Software zum ersten Mal installiert wird, ist nur die neueste Version der Mandantenmanagement-API aktiviert. Wenn StorageGRID jedoch auf eine neue Funktionsversion aktualisiert wird, haben Sie weiterhin Zugriff auf die ältere API-Version für mindestens eine StorageGRID-Funktionsversion.
Veraltete Anfragen werden wie folgt als veraltet markiert:
-
Der Antwortkopf ist "Deprecated: True"
-
Der JSON-Antwortkörper enthält „veraltet“: Wahr
Ermitteln, welche API-Versionen in der aktuellen Version unterstützt werden
Verwenden Sie die folgende API-Anforderung, um eine Liste der unterstützten API-Hauptversionen anzuzeigen:
GET https://{{IP-Address}}/api/versions
{
"responseTime": "2019-01-10T20:41:00.845Z",
"status": "success",
"apiVersion": "3.0",
"data": [
2,
3
]
}
Angeben einer API-Version für eine Anforderung
Sie können die API-Version mithilfe eines Pfadparameters angeben (/api/v3) Oder eine Kopfzeile (Api-Version: 3). Wenn Sie beide Werte angeben, überschreibt der Kopfzeilenwert den Pfadwert.
curl https://[IP-Address]/api/v3/grid/accounts curl -H "Api-Version: 3" https://[IP-Address]/api/grid/accounts