Skip to main content

​
Overview

Objects are the files stored within your containers. Each object has a name, payload, content type, and optional custom metadata. Objects can be any size — files over 5 GB require the Large Object mechanism (see Large Objects).
Prerequisites
  • An active Xloud account with appropriate permissions
  • Access to the Xloud Dashboard (https://connect.<your-domain>) or CLI configured with credentials
  • API credentials sourced (source admin-openrc.sh)
A container must exist before objects can be uploaded. See Create a Container to provision one.

​
Upload Objects

1

Open the container

Navigate to Project → Object Store → Containers and click the container name.
2

Upload files

Click Upload File and select the file from your local filesystem. For multiple files, use the Upload Folder option to upload directory contents recursively.
Set custom metadata during upload by expanding the Custom Metadata section. Add key-value pairs for tagging, workflow state, or application-specific properties.
3

Confirm upload

Uploaded objects appear in the container file browser with their size and last modified timestamp.
Object is listed in the container with the correct file size.

​
Download Objects

Navigate to the container, click the object name, and click Download.

​
List and Inspect Objects

openstack object list app-backups

​
Generate Temporary URLs

Temporary URLs provide time-limited access to objects without requiring authentication tokens — useful for sharing objects with external parties.
First, configure a temporary URL signing key on the account:
Set temporary URL key
openstack object store account set \
  --property Temp-URL-Key=$(openssl rand -hex 32)
Store this key securely — it is required to generate all temporary URLs.

​
Delete Objects

openstack object delete app-backups backup-2025-03-18.tar.gz

​
Next Steps

Access Control

Configure ACLs to control who can access the container and its objects

Large Objects

Upload files larger than 5 GB using SLO or DLO

Versioning

Protect objects from accidental overwrites with version retention

Troubleshooting

Resolve upload failures and access errors