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.

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: