Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Object Storage
    • Все инструкции
      • Загрузить объект
      • Загрузить объект составной (multipart) загрузкой
      • Получить список объектов в бакете
      • Получить информацию об объекте
      • Скачать объект
      • Восстановить версию объекта
      • Переименовать и переместить объект
      • Скопировать объект
      • Скачать объект по подписанной ссылке (pre-signed URL)
      • Загрузить объект по подписанной ссылке (pre-signed URL)
      • Блокировать версии объекта
      • Удалить объект
      • Удалить все объекты
      • Удалить частично загруженный объект
      • Редактировать ACL объекта
      • Управлять метками объекта
      • Управлять пользовательскими метаданными объекта
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Логи бакета
  • История изменений
  • Вопросы и ответы
  • Обучающие курсы
  1. Пошаговые инструкции
  2. Объекты
  3. Получить список объектов в бакете

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

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 18 сентября 2026 г.
Открыть в Markdown
Консоль управления
Yandex Cloud CLI
AWS CLI
API
  1. В консоли управления выберите каталог.

  2. Перейдите в сервис Object Storage.

  3. Выберите нужный бакет из списка и перейдите на вкладку Объекты.

    Отобразится список объектов и папок.

    Чтобы посмотреть список объектов в папке, нажмите на нее. В версионируемых бакетах, чтобы посмотреть историю изменений всех объектов в списке, включите опцию Показать версии.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

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

    yc storage s3api list-objects --help
    
  2. Получите список бакетов в каталоге по умолчанию:

    yc storage bucket list
    

    Результат:

    +------------------+----------------------+-------------+-----------------------+---------------------+
    |       NAME       |      FOLDER ID       |  MAX SIZE   | DEFAULT STORAGE CLASS |     CREATED AT      |
    +------------------+----------------------+-------------+-----------------------+---------------------+
    | first-bucket     | b1gmit33ngp6******** | 53687091200 | STANDARD              | 2022-12-16 13:58:18 |
    +------------------+----------------------+-------------+-----------------------+---------------------+
    
  3. Выполните команду:

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

    Где:

    • --bucket — имя бакета.
    • --prefix — папка в бакете. Необязательный параметр.

    Результат:

    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********
    
  1. Если у вас еще нет AWS CLI, установите и сконфигурируйте его.

  2. Чтобы получить список объектов в бакете, выполните команду:

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

    Где:

    • --endpoint-url — эндпоинт Object Storage.
    • --bucket — имя бакета.
    • --prefix — папка в бакете. Необязательный параметр.

    Результат:

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

Чтобы получить список объектов в бакете, воспользуйтесь методом S3 API listObjects.

Была ли статья полезна?

Предыдущая
Загрузить объект составной (multipart) загрузкой
Следующая
Получить информацию об объекте
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»