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

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

По умолчанию используется каталог, указанный при создании профиля 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.