[Yandex Cloud documentation](../../../index.md) > [Yandex Object Storage](../../index.md) > [Step-by-step guides](../index.md) > Buckets > Getting a list of buckets

# Getting a list of buckets

{% list tabs group=instructions %}

- Management console {#console}

  1. In the [management console](https://console.yandex.cloud), select a folder.
  1. Navigate to **Object Storage**.
  
  The page that opens will display the complete list of [buckets](../../concepts/bucket.md).

- Yandex Cloud CLI {#cli}

  If you do not have the Yandex Cloud CLI yet, [install and initialize it](../../../cli/quickstart.md#install).

  The folder used by default is the one specified when [creating](../../../cli/operations/profile/profile-create.md) 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](../../concepts/bucket.md):

     ```bash
     yc storage bucket --help
     ```

  1. Get a list of buckets in the default folder:
     
     ```bash
     yc storage bucket list
     ```
     
     Result:
     
     ```text
     +------------------+----------------------+-------------+-----------------------+---------------------+
     |       NAME       |      FOLDER ID       |  MAX SIZE   | DEFAULT STORAGE CLASS |     CREATED AT      |
     +------------------+----------------------+-------------+-----------------------+---------------------+
     | first-bucket     | b1gmit33ngp6******** | 53687091200 | STANDARD              | 2022-12-16 13:58:18 |
     +------------------+----------------------+-------------+-----------------------+---------------------+
     ```

- AWS CLI {#aws-cli}

  1. If you do not have the AWS CLI yet, [install and configure it](../../tools/aws-cli.md).
  1. To get the list of [buckets](../../concepts/bucket.md), run this command:

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

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

      Result:

      ```json
      {
          "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
      }
      ```

- API {#api}

  To get a list of [buckets](../../concepts/bucket.md), use the [list](../../api-ref/Bucket/list.md) REST API method for the [Bucket](../../api-ref/Bucket/index.md) resource, the [BucketService/List](../../api-ref/grpc/Bucket/list.md) gRPC API call or the [listBuckets](../../s3/api-ref/bucket/list.md) S3 API method.

{% endlist %}