Getting a list of buckets

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

1. View the description of the CLI command for getting a list of buckets:

   yc storage bucket --help
   

2. Get a list of buckets in the default folder:

   yc storage bucket list
   

   Result:

   +------------------+----------------------+-------------+-----------------------+---------------------+
   |       NAME       |      FOLDER ID       |  MAX SIZE   | DEFAULT STORAGE CLASS |     CREATED AT      |
   +------------------+----------------------+-------------+-----------------------+---------------------+
   | first-bucket     | b1gmit33ngp6******** | 53687091200 | STANDARD              | 2022-12-16 13:58:18 |
   +------------------+----------------------+-------------+-----------------------+---------------------+
   

1. If you do not have the AWS CLI yet, install and configure it.

2. To get the list of buckets, run this command:

   aws s3api list-buckets \
     --endpoint-url=https://storage.yandexcloud.net
   

   Where --endpoint-url is the Object Storage endpoint.

   Result:

   {
       "Buckets": [
           {
               "Name": "storage-********",
               "CreationDate": "2026-04-30T09:48:38.836000+00:00"
           },
           {
               "Name": "storage-********",
               "CreationDate": "2026-04-30T09:48:45.365000+00:00"
           }
       ],
       "Owner": {
           "DisplayName": "",
           "ID": ""
       },
       "Prefix": null
   }
   

To get a list of buckets, use the list REST API method for the Bucket resource, the BucketService/List gRPC API call or the listBuckets S3 API method.