Skip to main content

tritonctl storage

tritonctl storage lists your tenant's object storage: buckets, storage users, and access keys. It is read-only. Creating or deleting any of these is an operator action. See How object storage works.

Synopsis​

tritonctl storage buckets
tritonctl storage users
tritonctl storage access-keys --user <STORAGE_USER>

storage and its subcommands have no aliases.

Common behavior​

The silo and tenant come from your signed-in identity. No project is needed. The global flags and output formats are described in the tritonctl command index. Every subcommand prints a table, -l selects the long column set, and -j prints the raw JSON.

A tenant with no storage workspace bound gets 412 with the code TenantStorageUnbound from every subcommand.

tritonctl storage buckets​

Lists the buckets in your workspace, with object counts and total sizes. It always asks the server for statistics.

API route: GET /v1/silos/{silo_id}/tenants/{tenant_id}/storage/buckets?stats=true

ColumnDefaultLongContent
nameyesyesBucket name
owneryesyesOwning storage user
workspaceyesWorkspace name
objectsyesObject count
object_countyesObject count
sizeyesTotal size, human-readable
total_bytesyesTotal size in bytes
ageyesTime since creation
created_atyesCreation time, RFC 3339

Sorted by name.

tritonctl storage users​

Lists the storage users in your workspace. Storage users own access keys.

API route: GET /v1/silos/{silo_id}/tenants/{tenant_id}/storage/users

ColumnDefaultLongContent
nameyesyesStorage user name
workspaceyesWorkspace name
ageyesTime since creation
created_atyesCreation time, RFC 3339

Sorted by name.

tritonctl storage access-keys​

Lists one storage user's access keys. The secret access key is never shown.

API route: GET /v1/silos/{silo_id}/tenants/{tenant_id}/storage/users/{user}/access-keys

OptionRequiredDescription
--user <STORAGE_USER>yesThe storage user whose keys to list.
ColumnDefaultLongContent
access_key_idyesyesAccess key ID
useryesyesOwning storage user
workspaceyesWorkspace name
statusyesyesKey status, such as Active or Revoked
ageyesTime since creation
created_atyesCreation time, RFC 3339

Sorted by created_at, newest first.

Examples​

tritonctl storage buckets
tritonctl storage access-keys --user <STORAGE_USER> -l

See also​