Object Storage CLI Reference - Polystack Documentation

Overview

The openstack container and openstack object command groups manage Swift-compatible object storage — containers, objects, metadata, and access policies.

Prerequisites

CLI installed and authenticated — see CLI Setup
Python swiftclient installed: pip install python-swiftclient

Containers

openstack container list

openstack container create my-bucket

openstack container show my-bucket

openstack container set --property owner=team-a my-bucket

openstack container set \
  --property "X-Container-Read=.r:*,.rlistings" \
  my-bucket

openstack container delete my-bucket

Objects

openstack object list my-bucket
openstack object list --prefix logs/ my-bucket

openstack object create my-bucket ./report.pdf

openstack object create --name backups/2026-01-01.tar.gz my-bucket ./backup.tar.gz

swift upload my-bucket ./my-directory/

openstack object show my-bucket report.pdf

openstack object save my-bucket report.pdf

openstack object save --file /tmp/report.pdf my-bucket report.pdf

openstack object delete my-bucket report.pdf

Large Objects (Segmented)

swift upload --segment-size 1G --use-slo my-bucket large-file.iso

openstack object list my-bucket_segments

Temporary URLs

swift tempurl GET 3600 \
  /v1/AUTH_<project-id>/my-bucket/report.pdf \
  <temp-url-key>

swift post -m "Temp-Url-Key:<your-secret-key>"

Next Steps

Create Container Guide

Step-by-step guide to creating containers and uploading objects

Access Control Guide

Configure container and object access policies