Astra Trident REST API
While tridentctl commands and options are the easiest way to interact with the Astra Trident REST API, you can use the REST endpoint directly if you prefer.
When to use the REST API
REST API is useful for advanced installations that use Astra Trident as a standalone binary in non-Kubernetes deployments.
For better security, the Astra Trident
REST API is restricted to localhost by default when running inside a pod. To change this behavior, you need to set Astra Trident’s
-address argument in its pod configuration.
Using REST API
The API works as follows:
GET <trident-address>/trident/v1/<object-type>: Lists all objects of that type.
GET <trident-address>/trident/v1/<object-type>/<object-name>: Gets the details of the named object.
POST <trident-address>/trident/v1/<object-type>: Creates an object of the specified type.
Requires a JSON configuration for the object to be created. For the specification of each object type, see
tridentctlcommands and options.
If the object already exists, behavior varies: backends update the existing object, while all other object types will fail the operation.
DELETE <trident-address>/trident/v1/<object-type>/<object-name>: Deletes the named resource.
Volumes associated with backends or storage classes will continue to exist; these must be deleted separately. For more information, see
For examples of how these APIs are called, pass the debug (
-d) flag. For more information, see
tridentctl commands and options.