VK Cloud logo
Обновлена 15 апреля 2024 г. в 08:50

Управление объектами в бакете

Просмотр списка объектов

  1. Перейдите в личный кабинет VK Cloud.
  2. Выберите проект, где находится нужный бакет.
  3. Перейдите в раздел Объектное хранилище → Бакеты.
  4. Нажмите на имя нужного бакета.

Скачивание объекта

  1. Перейдите в личный кабинет VK Cloud.

  2. Выберите проект, где находится нужный бакет.

  3. Перейдите в раздел Объектное хранилище → Бакеты.

  4. Нажмите на имя нужного бакета.

  5. Выполните одно из действий для нужного объекта:

    • Выберите с помощью флажка объект, затем нажмите кнопку Скачать.
    • Раскройте меню объекта и выберите пункт Скачать файл.

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

Загруженные в бакет объекты по умолчанию имеют уровень доступа private, то есть их можно скачать только:

  • в личном кабинете VK Cloud;
  • через CLI, API, SDK и файловые менеджеры, если есть ключи доступа к бакету или аккаунту.

Вы можете изменить уровень доступа объекта, чтобы сделать его доступным сторонним пользователям. Уровни доступа соответствуют фиксированным ACL. По умолчанию доступны уровни:

  • private — полные права доступа при наличии ключей доступа к бакету или аккаунту, всем остальным объект не доступен;
  • public-read — полные права доступа при наличии ключей, остальным пользователям VK Cloud и сторонним пользователям объект доступен только для чтения;
  • authenticated-read — полные права доступа при наличии ключей, остальным пользователям VK Cloud объект доступен только для чтения.

Чтобы изменить уровень доступа к объекту:

Это групповая операция: при необходимости можно изменить настройки доступа сразу для нескольких объектов, выбрав их с помощью флажков.

  1. Перейдите в личный кабинет VK Cloud.
  2. Выберите проект, где находится нужный бакет.
  3. Перейдите в раздел Объектное хранилище → Бакеты.
  4. Нажмите на имя нужного бакета.
  5. Раскройте меню нужного объекта и выберите Доступ к файлу.
  6. В поле Настройка ACL выберите нужную настройку доступа и нажмите Сохранить изменения. При выборе public-read или authenticated-read после сохранения изменений появится ссылка на доступ к объекту.
  7. Скопируйте ссылку и закройте окно настройки доступа.
  8. Отправьте ссылку пользователям или разместите ее на стороннем ресурсе для прямого доступа к объекту.

Предоставление доступа к объекту по подписанному URL

Подписанный URL предоставляет полный доступ к объекту стороннему пользователю, но ограничен по времени.

Для генерации подписанного URL:

  1. Установите и настройте AWS CLI, если он еще не установлен.

  2. Откройте консоль и выполните команду:

    aws s3 presign s3://<имя_бакета>/<ключ_объекта> --endpoint-url <домен> --expires-in <время_действия>

    Здесь:

    • <ключ_объекта> — имя объекта и путь до него, включая папки, если они есть.
    • <домен> — домен сервиса Cloud Storage, должен соответствовать региону аккаунта:
      • https://hb.ru-msk.vkcs.cloud — домен региона Москва;
      • https://hb.kz-ast.vkcs.cloud — домен региона Казахстан.
    • <время_действия> — время действия доступа в секундах. Если не указано, ссылка будет действовать 3600 секунд.

Копирование объекта

Инструкция подходит для копирования объекта в пределах одного бакета или между бакетами одного проекта.

  1. Установите и настройте AWS CLI, если он еще не установлен.

  2. Откройте консоль и выполните команду:

    aws s3 cp s3://<бакет_источник>/<ключ_объекта> s3://<бакет_приемник>/<ключ_объекта> --endpoint-url=<домен>

    Здесь:

    • <бакет_источник> — имя бакета, из которого копируется объект.
    • <бакет_приемник> — имя бакета, в который копируется объект. Если имена совпадают, объект копируется в тот же бакет.
    • <ключ_объекта> — имя объекта и путь до него, включая папки, если они есть.
    • <домен> — домен сервиса Cloud Storage, должен соответствовать региону аккаунта:
      • https://hb.ru-msk.vkcs.cloud — домен региона Москва;
      • https://hb.kz-ast.vkcs.cloud — домен региона Казахстан.

Копирование всех объектов бакета

  1. Установите и настройте AWS CLI, если он еще не установлен.

  2. Откройте консоль и выполните команду:

    aws s3 cp --recursive s3://<бакет_источник> s3://<бакет_приемник> --endpoint-url=<домен>

    Здесь:

    • <бакет_источник> — имя бакета, из которого копируется объект.
    • <бакет_приемник> — имя бакета, в который копируется объект. Если имена совпадают, объект копируется в тот же бакет.
    • <домен> — домен сервиса Cloud Storage, должен соответствовать региону аккаунта:
      • https://hb.ru-msk.vkcs.cloud — домен региона Москва;
      • https://hb.kz-ast.vkcs.cloud — домен региона Казахстан.

Удаление объекта

Это групповая операция: при необходимости можно удалить сразу несколько объектов, выбрав их с помощью флажков.

Для удаления объекта:

  1. Перейдите в личный кабинет VK Cloud.

  2. Выберите проект, где находится нужный бакет.

  3. Перейдите в раздел Объектное хранилище → Бакеты.

  4. Нажмите на имя нужного бакета. Откроется страница с информацией о бакете на вкладке Папки и файлы.

  5. Выполните одно из действий для нужного объекта:

    • Выберите с помощью флажка объект, затем нажмите кнопку Удалить.
    • Раскройте меню объекта и выберите пункт Удалить файл.
  6. Подтвердите удаление.

Удаление частей загруженного объекта

Если составная загрузка не завершена, объект не создается и не может использоваться, но хранение загруженных частей тарифицируется. Чтобы средства не списывались, удаляйте составные загрузки, которые не будут завершены.

Вы можете настроить автоматическое удаление незавершенных загрузок через жизненный цикл объектов или удалить загрузку вручную.

Чтобы узнать, есть ли у вас незавершенные составные загрузки:

  1. Перейдите в личный кабинет VK Cloud.
  2. Перейдите в раздел Объектное хранилищеБакеты.
  3. Нажмите на имя нужного бакета и перейдите на вкладку Multipart.

Чтобы удалить незавершенные загрузки:

Это групповая операция: при необходимости можно удалить сразу несколько частей, выбрав их с помощью флажков.

  1. Перейдите в личный кабинет VK Cloud.

  2. Перейдите в раздел Объектное хранилищеБакеты.

  3. Нажмите на имя нужного бакета и перейдите на вкладку Multipart.

  4. Выполните одно из действий для нужной части:

    • Выберите с помощью флажка часть, затем нажмите кнопку Удалить над таблицей.
    • Выберите часть, которую нужно удалить, и нажмите на значок Удалить справа.
  5. Подтвердите удаление.