Trident REST API
Änderungen vorschlagen
PDFs
Während "tridentctl commands und Optionen" die einfachste Möglichkeit sind, mit der Trident REST API zu interagieren, können Sie den REST-Endpunkt auch direkt verwenden, wenn Sie dies bevorzugen.
Wann sollte die REST API verwendet werden?
REST API ist nützlich für fortgeschrittene Installationen, die Trident als eigenständige Binärdatei in Nicht-Kubernetes-Bereitstellungen verwenden.
Für bessere Sicherheit ist Trident REST API standardmäßig auf localhost beschränkt, wenn es in einem Pod ausgeführt wird. Um dieses Verhalten zu ändern, müssen Sie das Argument von Trident -address in seiner Pod-Konfiguration festlegen.
Verwendung der REST API
Beispiele dafür, wie diese APIs aufgerufen werden, erhalten Sie, wenn Sie das Debug-(-d-Flag übergeben. Weitere Informationen finden Sie unter "Trident mit tridentctl verwalten".
Die API funktioniert wie folgt:
GET
GET <trident-address>/trident/v1/<object-type>-
Listet alle Objekte dieses Typs auf.
GET <trident-address>/trident/v1/<object-type>/<object-name>-
Ruft die Details des benannten Objekts ab.
POST
POST <trident-address>/trident/v1/<object-type>-
Erzeugt ein Objekt des angegebenen Typs.
-
Für die Erstellung des Objekts ist eine JSON-Konfiguration erforderlich. Die Spezifikation der einzelnen Objekttypen finden Sie unter "Trident mit tridentctl verwalten".
-
Wenn das Objekt bereits existiert, variiert das Verhalten: Backends aktualisieren das bestehende Objekt, während bei allen anderen Objekttypen der Vorgang fehlschlägt.
-
LÖSCHEN
DELETE <trident-address>/trident/v1/<object-type>/<object-name>-
Löscht die benannte Ressource.
Zu Backends oder Speicherklassen gehörende Volumes bleiben bestehen; diese müssen separat gelöscht werden. Weitere Informationen finden Sie unter "Trident mit tridentctl verwalten".