---
title: "ls"
slug: "ls"
updated: 2026-10-08T04:57:31Z
published: 2026-10-08T04:57:31Z
canonical: "cli.ncloud-docs.com/ls"
---

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

# ls

Available in Classic and VPC

Get the list of buckets, folders, or objects.

## Syntax

The `ls` syntax is as follows:

```
aws s3 ls \
    [<s3-uri>] \
    [--recursive] \
    [--page-size <page-size>] \
    [--human-readable] \
    [--summarize] \
    --endpoint-url <endpoint-url>
```

## Options

This section describes the options available when running `ls`.

### Optional options

These are the optional options for `ls`. Options that are not specified will use their default values.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `&lt;s3-uri&gt;` | String | Optional | S3 URI for a bucket or path - Enter in the format of `s3://{bucket_name}[/{prefix}]`. - If left blank, retrieves all buckets owned by the account. |
| `--recursive` | Boolean | Optional | Retrieves sub-prefixes under the specified path. |
| `--page-size` | Integer | Optional | Number of items per page - `1`-`1000` |
| `--human-readable` | Boolean | Optional | Displays object sizes in human-readable units such as bytes, KiB, MiB, GiB, etc. |
| `--summarize` | Boolean | Optional | Displays the total number of objects and their total size in the query results. |

### Common options

For information about the options common to all `aws` subcommands, see [Ncloud Storage options](/docs/en/storage-ncloudstorage#%EC%98%B5%EC%85%98).

## Examples

If the request to retrieve the list is successful, the creation date and time and name of the bucket, as well as the last modified date and time, size, and name of each object, are displayed. Subprefixes are displayed in the format `PRE {prefix}/`.

### Command

The following is an example command to get the list of all buckets owned by the account.

```
aws s3 ls \
    --endpoint-url=https://kr.ncloudstorage.com
```

The following is an example command for listing the objects in a bucket.

```
aws s3 ls s3://my-test-bucket \
    --endpoint-url=https://kr.ncloudstorage.com
```

The following is an example command for checking the total number of objects and the size of a bucket.

```
aws s3 ls s3://my-test-bucket \
    --recursive \
    --human-readable \
    --summarize \
    --endpoint-url=https://kr.ncloudstorage.com
```

### Output

The following is an example output for retrieving a list of all buckets owned by an account.

```
2026-08-21 14:06:10 my-encrypted-bucket
2026-08-19 11:57:28 my-locked-bucket
2026-08-21 14:06:07 my-sync-bucket
2026-08-19 11:44:27 my-test-bucket
```

The following is an example output for retrieving the list of objects in a bucket.

```
PRE img/
2026-08-19 11:56:40   12582912 large.bin
2026-08-19 11:44:28         48 sample.txt
```

The following is an example output for retrieving the total number and size of objects in a bucket.

```
2026-08-19 11:49:44   20 Bytes img/copy.png
2026-08-19 11:49:43   20 Bytes img/image.png
2026-08-19 11:49:44   20 Bytes img/image2.png
2026-08-19 11:56:40   12.0 MiB large.bin
2026-08-19 11:44:28   48 Bytes sample.txt

Total Objects: 5
   Total Size: 12.0 MiB
```