# 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) |
|`--timeout` | Per-zone timeout for list operations; -1s disables timeout [env EXOSCALE_TIMEOUT] |
|`--use-account, -A` | Account to use in config file [env EXOSCALE_ACCOUNT] |


### Related Commands

* [storage]({{< ref "../storage">}})	 - Object Storage management