---
title: "list-buckets"
slug: "list-buckets"
updated: 2026-10-08T04:58:08Z
published: 2026-10-08T04:58:08Z
canonical: "cli.ncloud-docs.com/list-buckets"
---

> ## 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.

# list-buckets

Available in Classic and VPC

Get the list of Ncloud Storage buckets.

              Note

              

For a Sub Account user to execute this command, they must have the View/ListAllMyBuckets action permission.

## Syntax

The `list-buckets` syntax is as follows:

```
aws s3api list-buckets \
    --endpoint-url <endpoint-url>
```

## Options

This section describes the options available when running `list-buckets`.

### 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 bucket list is successful, the identification and ownership information for each bucket is returned.

### Command

The command example is as follows:

```
aws s3api list-buckets \
    --endpoint-url=https://kr.ncloudstorage.com
```

### Output

The output example is as follows:

```
{
    "Buckets": [
        {
            "Name": "my-test-bucket",
            "CreationDate": "2026-08-19T02:44:27Z"
        }
    ],
    "Owner": {
        "DisplayName": "",
        "ID": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "Prefix": null
}
```

## Related commands

Related commands are as follows:

- [create-bucket](/docs/en/create-bucket)
- [delete-bucket](/docs/en/delete-bucket)
- [head-bucket](/docs/en/head-bucket)