[Документация Yandex Cloud](../../../index.md) > [Yandex Object Storage](../../index.md) > [Справочник YC CLI (англ.)](../index.md) > [s3api](index.md) > list-objects

# yc storage s3api list-objects

Lists objects in a bucket using listObjectsV2 http method

#### Command Usage

Syntax:

`yc storage s3api list-objects [Flags...] [Global Flags...]`

Aliases:

- `list-objects-v2`

#### Flags

#|
||Flag | Description ||
|| `--bucket` | `string`

[REQUIRED] Bucket name ||
|| `--prefix` | `string`

Limits the response to keys that begin with the specified prefix. ||
|| `--delimiter` | `string`

A delimiter is a character that is used to group keys. ||
|| `--start-after` | `string`

Starts listing after this specified key. StartAfter can be used with listing objects in a bucket. ||
|| `--max-keys` | `int32`

The maximum number of keys returned in the response. By default, the action returns up to 1,000 key names. ||
|| `--continuation-token` | `string`

Used to continue a list objects operation. Contains the value returned as NextContinuationToken in the previous response. ||
|| `--fetch-owner` | Specifies whether to include the owner information in the response. By default, this is not included. ||
|#

#### 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

 * [Получение подписанной ссылки (pre-signed URL) на скачивание объекта](../../operations/objects/link-for-download.md#cli_1)
 * [Получение списка объектов в бакете](../../operations/objects/list.md#cli_1)
 * [Получить метаданные объекта](../../operations/objects/object-meta.md#cli_2)