ListBuckets

Prev Next

Available in Classic and VPC

Get the list of Ncloud Storage buckets.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET -

Request headers

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage request headers.

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
bucket-region String Optional Bucket Region
  • kr: Korea Region (valid value)
continuation-token String Optional Next page query identifier
  • ContinuationToken value of the previous response result
  • Length (byte): 0-1024
max-buckets Integer Optional Number of items per page
  • 1-10,000
prefix String Optional Bucket name prefix

Request example

The request example is as follows:

GET /?bucket-region=kr&max-buckets=1 HTTP/1.1
Host: kr.ncloudstorage.com

Response

This section describes the response format.

Response headers

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage response headers.

Response body

The response body includes the following data:

Field Type Required Description
ListAllMyBucketsResult Object - Bucket list query result
ListAllMyBucketsResult.Owner Object - Bucket owner information
ListAllMyBucketsResult.Owner.ID Integer - User's NAVER Cloud Platform member ID
ListAllMyBucketsResult.Owner.DisplayName String - User's name
ListAllMyBucketsResult.Buckets Object - Bucket information
ListAllMyBucketsResult.Buckets.Bucket Array - Bucket list
ListAllMyBucketsResult.ContinuationToken String Optional Next page query identifier
  • Display if a next page exists.
  • Length 0-1024 (byte)
ListAllMyBucketsResult.Prefix String - Bucket name prefix

Bucket

The following describes Bucket.

Field Type Required Description
Name String - Bucket name
CreationDate String - Bucket creation date and time
  • ISO 8601 format

Response status codes

For information about the HTTP status codes common to all Ncloud Storage APIs, see Common Ncloud Storage response status codes.

Response example

The response example is as follows:

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
    <Owner>
        <ID>260****</ID>
        <DisplayName>260****</DisplayName>
    </Owner>
    <Buckets>
        <Bucket>
            <Name>bucket</Name>
            <CreationDate>2025-04-23T09:22:26Z</CreationDate>
        </Bucket>
    </Buckets>
</ListAllMyBucketsResult>