[Yandex Cloud documentation](../../../index.md) > [Yandex Object Storage](../../index.md) > [YC CLI reference](../index.md) > [bucket](index.md) > list

# yc storage bucket list

Lists buckets of specified folder id

#### Command Usage

Syntax:

`yc storage bucket list [Flags...] [Global Flags...]`

#### Flags

#|
||Flag | Description ||
|| `--limit` | `int`

The maximum number of items to list. Default is 1000 items ||
|#

#### Global Flags

#|
||Flag | Description ||
|| `--profile` | `string`

Set the custom configuration file. ||
|| `--debug` | Debug logging. ||
|| `--debug-grpc` | Debug gRPC logging. Very verbose, used for debugging connection problems. ||
|| `--no-user-output` | Disable printing user intended output to stderr. ||
|| `--retry` | `int`

Enable gRPC retries. By default, retries are enabled with maximum 5 attempts.
Pass 0 to disable retries. Pass any negative value for infinite retries.
Even infinite retries are capped with 2 minutes timeout. ||
|| `--cloud-id` | `string`

Set the ID of the cloud to use. ||
|| `--folder-id` | `string`

Set the ID of the folder to use. ||
|| `--folder-name` | `string`

Set the name of the folder to use (will be resolved to id). ||
|| `--endpoint` | `string`

Set the Cloud API endpoint (host:port). ||
|| `--token` | `string`

Set the OAuth token to use. ||
|| `--impersonate-service-account-id` | `string`

Set the ID of the service account to impersonate. ||
|| `--no-browser` | Disable opening browser for authentication. ||
|| `--format` | `string`

Set the output format: text (default), yaml, json, json-rest. ||
|| `--jq` | `string`

Query to select values from the response using jq syntax ||
|| `-h`, `--help` | Display help for the command. ||
|#
#### Examples

 * [Enabling public access](../../operations/buckets/bucket-availability.md#cli_1)
 * [Configuring CORS](../../operations/buckets/cors.md#cli_1)
 * [Deleting a bucket](../../operations/buckets/delete.md#cli_1)
 * [Disabling static keys for access to a bucket](../../operations/buckets/disable-statickey-auth.md#cli_1)
 * [Getting bucket information](../../operations/buckets/get-info.md#cli_1)
 * [Getting a list of buckets](../../operations/buckets/get-list.md#cli_1)
 * [Example](../../operations/buckets/iam-access.md#cli_1)
 * [Managing bucket object lifecycles](../../operations/buckets/lifecycles.md#cli_1)
 * [Limiting the maximum size of a bucket](../../operations/buckets/limit-max-volume.md#cli_1)
 * [Adding or updating labels](../../operations/buckets/tagging.md#cli_1)
 * [Copying a single object](../../operations/objects/copy.md#cli_1)
 * [Deleting all objects from a bucket](../../operations/objects/delete-all.md#cli_1)
 * [Deleting an object or object version without a lock](../../operations/objects/delete.md#cli_1)
 * [Deleting a partially uploaded object](../../operations/objects/deleting-multipart.md#cli_1)
 * [Downloading an object](../../operations/objects/download.md#cli_1)
 * [Setting or configuring retention (governance- or compliance-mode)](../../operations/objects/edit-object-lock.md#cli_1)
 * [Getting information about an object](../../operations/objects/info.md#cli_1)
 * [Getting a pre-signed URL to download an object](../../operations/objects/link-for-download.md#cli_1)
 * [Getting a pre-signed URL to upload an object](../../operations/objects/link-for-upload.md#cli_1)
 * [Get a list of bucket objects](../../operations/objects/list.md#cli_1)
 * [Create a multipart upload in a bucket](../../operations/objects/multipart-upload.md#cli_1)
 * [Uploading an object with metadata](../../operations/objects/object-meta.md#cli_1)
 * [Renaming](../../operations/objects/rename-move.md#cli_1)
 * [Adding or updating labels](../../operations/objects/tagging.md#cli_1)
 * [Regular uploads](../../operations/objects/upload.md#cli_1)