---
title: "List Objects in a Bucket"
slug: "list-objects-in-a-bucket-s3cmd-tg"
updated: 2026-10-28T01:54:14Z
published: 2026-10-28T01:54:14Z
canonical: "docs.vastdata.com/list-objects-in-a-bucket-s3cmd-tg"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Objects in a Bucket

```plaintext
s3cmd [-c CONFIGFILE] ls [s3://BUCKET[/PREFIX]]}
```

| CONFIGFILE | Configuration file. Defaults to $HOME/.s3cfg |
| --- | --- |
| BUCKET | Name of bucket |
| PREFIX | Filter objects by prefix. Although the S3 structure is flat consisting of buckets containing objects with no hierarchy of subbuckets and subfolders, object keys can include prefixes separated by a delimiter. Hierarchy can be inferred from the prefixes. |

## Example

List objects in the bucket *bucket1*.

```plaintext
$ s3cmd -c vast.s3cfg ls s3://bucket1
2019-06-24 19:51  205 s3://bucket1/blue.txt
2019-06-24 19:52  93  s3://bucket1/brown.txt
2019-06-24 19:40  176 s3://bucket1/vast.s3cfg
```