[Документация Yandex Cloud](../../../index.md) > [Yandex Object Storage](../../index.md) > [Пошаговые инструкции](../index.md) > Объекты > Получение списка объектов в бакете

# Получение списка объектов в бакете

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог.
  1. Перейдите в сервис **Object Storage**.
  1. Выберите нужный бакет из списка.
  1. На панели слева выберите ![image](../../../_assets/console-icons/folder-tree.svg) **Объекты**. Отобразится список объектов и папок.

      Чтобы посмотреть список объектов в папке, нажмите на нее. В [версионируемых](../../concepts/versioning.md) бакетах, чтобы посмотреть историю изменений всех объектов в списке, включите опцию **Показать версии**.

- Yandex Cloud CLI {#cli}

  Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../cli/quickstart.md#install).

  По умолчанию используется каталог, указанный при [создании](../../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды CLI для получения списка объектов в бакете:

      ```bash
      yc storage s3api list-objects --help
      ```

  1. Получите список бакетов в каталоге по умолчанию:
     
     ```bash
     yc storage bucket list
     ```
     
     Результат:
     
     ```text
     +------------------+----------------------+-------------+-----------------------+---------------------+
     |       NAME       |      FOLDER ID       |  MAX SIZE   | DEFAULT STORAGE CLASS |     CREATED AT      |
     +------------------+----------------------+-------------+-----------------------+---------------------+
     | first-bucket     | b1gmit33ngp6******** | 53687091200 | STANDARD              | 2022-12-16 13:58:18 |
     +------------------+----------------------+-------------+-----------------------+---------------------+
     ```
  1. Выполните команду:

      ```bash
      yc storage s3api list-objects \
        --bucket <имя_бакета> \
        --prefix <префикс_ключа_объекта>
      ```

      Где:

      * `--bucket` — имя бакета.
      * `--prefix` — [папка](../../concepts/object.md#folder) в бакете. Необязательный параметр.

      Результат:

      ```text
      contents:
        - key: my-folder/
          last_modified: "2025-04-05T09:21:30.870Z"
          etag: '"d41d8cd98f00b204e9800998********"'
          owner:
            id: aje9k8luj4qf********
            display_name: aje9k8luj4qf********
          storage_class: STANDARD
        - key: my-folder/clouds.jpg
          last_modified: "2025-04-05T09:22:00.542Z"
          etag: '"e48cfc54e831ee0b334a00f9********"'
          size: "455747"
          owner:
            id: aje9k8luj4qf********
            display_name: aje9k8luj4qf********
          storage_class: STANDARD
        - key: my-folder/nice_text.txt
          last_modified: "2025-04-05T09:21:40.023Z"
          etag: '"379e8ff6a0f89b09534753e3********"'
          size: "64154"
          owner:
            id: aje9k8luj4qf********
            display_name: aje9k8luj4qf********
          storage_class: STANDARD
      name: first-bucket
      prefix: my-folder/
      max_keys: "1000"
      key_count: "3"
      request_id: dc073b86********
      ```

- AWS CLI {#aws-cli}

  1. Если у вас еще нет AWS CLI, [установите и сконфигурируйте его](../../tools/aws-cli.md).
  1. Чтобы получить список объектов в бакете, выполните команду:

      ```bash
      aws s3api list-objects \
        --endpoint-url=https://storage.yandexcloud.kz \
        --bucket <имя_бакета> \
        --prefix <префикс_ключа_объекта>
      ```

      Где:

      * `--endpoint-url` — эндпоинт Object Storage.
      * `--bucket` — имя бакета.
      * `--prefix` — [папка](../../concepts/object.md#folder) в бакете. Необязательный параметр.

      Результат:

      ```json
      {
          "Contents": [
              {
                  "Key": "my-folder/",
                  "LastModified": "2025-04-05T09:21:30.870000+00:00",
                  "ETag": "\"d41d8cd98f00b204e9800998********\"",
                  "Size": 0,
                  "StorageClass": "STANDARD",
                  "Owner": {
                      "DisplayName": "aje9k8luj4qf********",
                      "ID": "aje9k8luj4qf********"
                  }
              },
              {
                  "Key": "my-folder/clouds.jpg",
                  "LastModified": "2025-04-05T09:22:00.542000+00:00",
                  "ETag": "\"e48cfc54e831ee0b334a00f9********\"",
                  "Size": 455747,
                  "StorageClass": "STANDARD",
                  "Owner": {
                      "DisplayName": "aje9k8luj4qf********",
                      "ID": "aje9k8luj4qf********"
                  }
              },
              {
                  "Key": "my-folder/nice_text.txt",
                  "LastModified": "2025-04-05T09:21:40.023000+00:00",
                  "ETag": "\"379e8ff6a0f89b09534753e3********\"",
                  "Size": 64154,
                  "StorageClass": "STANDARD",
                  "Owner": {
                      "DisplayName": "aje9k8luj4qf********",
                      "ID": "aje9k8luj4qf********"
                  }
              },
          ],
          "RequestCharged": null
      }
      ```

- API {#api}

  Чтобы получить список объектов в бакете, воспользуйтесь методом S3 API [listObjects](../../s3/api-ref/bucket/listobjects.md).

{% endlist %}