To list all of the files of an S3 bucket with the AWS CLI, use the `s3 ls` command, passing in the `--recursive` parameter.

List all Files in an S3 Bucket with AWS CLI


## Table of Contents

1. [List all Files in an S3 Bucket with AWS CLI](/blog/aws-cli-list-all-files-in-bucket#list-all-files-in-an-s3-bucket-with-aws-cli)
2. [List all Files in a Folder of an S3 Bucket](/blog/aws-cli-list-all-files-in-bucket#list-all-files-in-a-folder-of-an-s3-bucket)
3. [List only the Filenames of an S3 Bucket](/blog/aws-cli-list-all-files-in-bucket#list-only-the-filenames-of-an-s3-bucket)

## List all Files in an S3 Bucket with AWS CLI

**To list all of the files of an S3 bucket with the AWS CLI, use the `s3 ls`
command, passing in the `--recursive` parameter.**

```bash:shell
aws s3 ls s3://YOUR_BUCKET --recursive --human-readable --summarize
```

![list all files in bucket](/images/blog/aws-cli-list-all-files-in-bucket/list-all-files-in-bucket.webp)

The output of the command shows the date the objects were created, their file
size and their path.

<InArticleAd />

<Alert>
  List requests are associated with a cost. At the time of writing the cost of{' '}
  <code>1,000</code> list requests is <code>$0.005</code> in the{' '}
  <code>us-east-1</code> region.
</Alert>

The parameters we've passed to the
[s3 ls](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html)
command are:

| Name           | Description                                               |
| -------------- | --------------------------------------------------------- |
| recursive      | performs the command on all files under the set prefix    |
| human-readable | displays the file sizes in human readable format          |
| summarize      | displays the total number of objects and their total size |

<Alert>
  If you only want to list all top-level objects remove the{' '}
  <code>--recursive</code> parameter from the command.
</Alert>

## List all Files in a Folder of an S3 Bucket

**To list all files, located in a folder of an S3 bucket, use the `s3 ls`
command, passing in the entire path to the folder and setting the `--recursive`
parameter.**

```bash:shell
aws s3 ls s3://YOUR_BUCKET/YOUR_FOLDER/ --recursive --human-readable --summarize
```

![list all files in bucket folder](/images/blog/aws-cli-list-all-files-in-bucket/list-all-files-in-bucket-folder.webp)

The output of the command only shows the files in the `/my-folder-1` directory.

<InArticleAd />

## List only the Filenames of an S3 Bucket

**To only list the filenames of an S3 bucket, we have to:**

1. **Use the `s3api list-objects` command**
2. **Set the `--output` parameter to `text`**
3. **Use the `--query` parameter to filter the output from the command**

```bash:shell
aws s3api list-objects --bucket YOUR_BUCKET --output text --query "Contents[].{Key: Key}"
```

![only list filenames of bucket](/images/blog/aws-cli-list-all-files-in-bucket/only-list-filenames-of-bucket.webp)

The output of the command shows all of the filenames, or in other words - path
names in the S3 bucket.

**To list only the filenames in a specific folder, add the `--prefix` parameter
to the command:**

```bash:shell
aws s3api list-objects --bucket YOUR_BUCKET --prefix "my-folder/" --output text --query "Contents[].{Key: Key}"
```

![only list filenames in folder](/images/blog/aws-cli-list-all-files-in-bucket/only-list-filenames-in-folder.webp)

We can also redirect the output to a file on the local file system:

```bash:shell
aws s3api list-objects --bucket YOUR_BUCKET --prefix "my-folder-1/" --output text --query "Contents[].{Key: Key}" > file-names.txt
```

![list filenames redirect output](/images/blog/aws-cli-list-all-files-in-bucket/list-filenames-redirect-output.webp)

<InArticleAd />

## Further Reading

- [AWS CDK Tutorial for Beginners - Step-by-Step Guide](/blog/aws-cdk-tutorial-typescript)
- [How does AWS CDK work](/blog/how-does-aws-cdk-work)
- [What is a Token in AWS CDK](/blog/what-is-aws-cdk-token)
- [CDK Constructs - Complete Guide](/blog/cdk-constructs-tutorial)
- [What is an identifier (id) in AWS CDK](/blog/aws-cdk-identifiers)
- [How to use Context in AWS CDK](/blog/how-to-use-context-aws-cdk)
- [How to use Parameters in AWS CDK](/blog/aws-cdk-parameters-example)

<InArticleAd />


List all Files in an S3 Bucket with AWS CLI

Table of Contents #

List all Files in an S3 Bucket with AWS CLI #

List all Files in a Folder of an S3 Bucket #

List only the Filenames of an S3 Bucket #

Further Reading #

Borislav Hadzhiev

For more articles, navigate to myHome Page

Name	Description
recursive	performs the command on all files under the set prefix
human-readable	displays the file sizes in human readable format
summarize	displays the total number of objects and their total size

List all Files in an S3 Bucket with AWS CLI

Table of Contents #

List all Files in an S3 Bucket with AWS CLI #

List all Files in a Folder of an S3 Bucket #

List only the Filenames of an S3 Bucket #

Further Reading #

Join my newsletter

Borislav Hadzhiev

For more articles, navigate to myHome Page