Skip to content
View as Markdown

Object storage CLI reference

Reference · Updated Sep 2026

Coming from another cloud?

▸AWS·Amazon S3

This Quake AI feature maps to AWS’s Amazon S3.

▸Azure·Blob Storage

This Quake AI feature maps to Azure’s Blob Storage.

▸DigitalOcean·Space (bucket)

Space (bucket)high

  • Naming differs: users create a “Space” that is a bucket, and each bucket has a unique URL (virtual-hosted or path style), whereas Swift uses containers within an account namespace. ().
  • Bucket addressing uses S3-style endpoints such as `${BUCKET}.${REGION}.digitaloceanspaces.com` (and `${REGION}.digitaloceanspaces.com/${BUCKET}`), which differs from Swift’s account/container/object path conventions. (, ).
  • Access keys can be scoped to high-level permission tiers (Read, Read/Write/Delete, All) applied across buckets/objects, which differs from Swift’s typical tenant/user + container ACL model. ().
DigitalOcean docs ↗
▸Google Cloud·Storage

This Quake AI feature maps to Google Cloud’s Storage.

▸Hetzner·Buckets

Bucketshigh

  • S3 API (PUT Bucket requires specific headers like x-amz-acl limited to private/public-read, LocationConstraint); Swift uses POST/PUT Container with broader ACLs via X-Container-Read/Write.
  • Public access via https://bucket.location.your-objectstorage.com/object; Swift public via temp URLs or ACLs.
  • Up to 100 buckets per account; Swift has no hard limit.
Hetzner docs ↗

Object storage CLI reference

The Swift command reference covers the swift client. The S3-compatible storage tools reference covers AWS CLI, s3cmd, and rclone.

See the OpenStackClient Object Storage v1 command reference for complete command syntax.

Use these commands to manage containers and objects in the Object Storage service. Replace CONTAINER_NAME, OBJECT_NAME, and LOCAL_FILE_PATH with the corresponding names and paths.

List containers#

bash
openstack container list

Create a container#

bash
openstack container create CONTAINER_NAME

Delete a container#

bash
openstack container delete CONTAINER_NAME

Show container details#

bash
openstack container show CONTAINER_NAME

List objects in a container#

bash
openstack object list CONTAINER_NAME

Upload an object to a container#

bash
openstack object create CONTAINER_NAME LOCAL_FILE_PATH

Download an object from a container#

bash
openstack object save CONTAINER_NAME OBJECT_NAME

Delete an object from a container#

bash
openstack object delete CONTAINER_NAME OBJECT_NAME

Show object details#

bash
openstack object show CONTAINER_NAME OBJECT_NAME

Output columns#

Select specific columns with --column COL1 --column COL2 or change the output format with -f json, -f csv, or -f table (default).

openstack container list#

ColumnDescription
NameContainer name

openstack container show#

FieldDescription
accountSwift account identifier (AUTH_PROJECT_UUID)
bytes_usedTotal bytes stored in the container
containerContainer name
object_countNumber of objects in the container
propertiesContainer metadata; Quake AI defaults expose Quota-Bytes (per-container max size) and Quota-Count (per-container max object count)
storage_policyStorage policy name; the default is default-placement

openstack object list#

ColumnDescription
NameObject name in the container

openstack object list --long#

ColumnDescription
NameObject name
BytesObject size in bytes
HashMD5 etag
Content TypeMIME type
Last ModifiedISO 8601 timestamp

openstack object show#

FieldDescription
accountSwift account identifier
containerContainer name
content-lengthObject size in bytes
content-typeMIME type
etagMD5 hash
last-modifiedRFC 1123 timestamp
objectObject name

See Also

Object Storage Service API Reference

Shares: Storage, Containers

→

Object Storage Console

Shares: Storage, Containers

→

How to access an uploaded file in object storage

Shares: Storage, Containers

→

How to create an object storage bucket

Shares: Storage, Containers

→

How to create a folder in an object storage bucket

Shares: Storage, Containers

→
Was this page helpful?