exo storage list
Description
This command lists buckets and their objects.
If no argument is passed, this commands lists existing buckets. If a prefix is specified (e.g. “sos://my-bucket/…/”) the command lists the objects stored in the bucket under the corresponding prefix.
Supported output template annotations:
- When listing buckets: .Name, .Zone, .Size, .Created
- When listing objects: .Path, .Size, .LastModified, .Dir, .VersionID, .VersionNumber
exo storage list [sos://BUCKET[/[PREFIX/]] [flags]Options
| Option | Description |
|---|---|
--exclude-versions | exclude versions from being listed; accepts comma separated version IDs(865029700534464769) and numbers(v123); implies –versions |
--help, -h | help for list |
--newer-than | only objects newer than a duration. Accepts durations in the format of Go's time.ParseDuration. examples: "2h45m", "10m", "45s" |
--newer-than-timestamp | only objects newer than an ISO 8601 timestamp. examples: '2023-06-07T10:00:00+02:00', use the date command $(date -d "yesterday 10am" –iso-8601=seconds) |
--older-than | only objects older than a duration. Accepts durations in the format of Go's time.ParseDuration. examples: "2h45m", "10m", "45s" |
--older-than-timestamp | only objects older than an ISO 8601 timestamp. examples: '2023-06-07T10:00:00+02:00', use the date command $(date -d "yesterday 10am" –iso-8601=seconds) |
--only-versions | limit the versions to be listed; accepts comma separated version IDs(865029700534464769) and numbers(v123); implies –versions |
--recursive, -r | list bucket recursively |
--stream, -s | stream listed files instead of waiting for complete listing (useful for large buckets) |
--versions | list all versions of objects(if the bucket is versioned) |
--zone, -z | Exoscale zone |
Options inherited from parent commands
| Option | Description |
|---|---|
--config, -C | Specify an alternate config file [env EXOSCALE_CONFIG] |
--output-format, -O | Output format (table|json|text), see "exo output –help" for more information |
--output-template | Template to use if output format is "text" |
--quiet, -Q | Quiet mode (disable non-essential command output) |
--use-account, -A | Account to use in config file [env EXOSCALE_ACCOUNT] |
Related Commands
- storage - Object Storage management