list-buckets

Available in Classic and VPC

Get the list of all buckets owned by the user.

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 Object 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.object.ncloudstorage.com

Output

The output example is as follows:

{
    "Buckets": [
        {
            "Name": "my-docs-bucket",
            "CreationDate": "2026-04-28T01:31:27.978Z"
        },
        {
            "Name": "my-test-bucket",
            "CreationDate": "2026-08-19T02:36:46.957Z"
        }
    ],
    "Owner": {
        "DisplayName": "ncp-123456-0",
        "ID": "ncp-123456-0"
    },
    "Prefix": null
}