Быстрый старт

Быстрый старт поможет вам начать работу с сервисом и познакомиться с его возможностями.

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

1. Убедитесь, что AWS CLI установлен.

2. Создайте аккаунт для сервиса VK Object Storage:

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

   2. Выберите проект.

   3. Перейдите в раздел Object Storage → Аккаунты.

   4. Нажмите кнопку Добавить аккаунт или Добавить.

   5. Задайте имя аккаунта.

   6. Нажмите кнопку Создать.

   7. В открывшемся окне скопируйте и сохраните идентификатор ключа доступа (Access Key ID) и секретный ключ (Secret Key).

3. Настройте AWS CLI на работу с созданным аккаунтом:

   1. Выполните команду:

       
      aws configure

   2. Задайте необходимые настройки:

      1. AWS Access Key ID: введите сохраненное ранее значение Access Key ID.
      2. AWS Secret Access Key: введите сохраненное ранее значение Secret Key.
      3. Default region name: введите ru-msk.
      4. Default output format: введите json.

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

2. Перейдите в раздел Object Storage → Бакеты.

3. Нажмите кнопку Создать.

4. Введите имя бакета, соответствующее рекомендуемым правилам.

   После создания бакета изменить его имя будет невозможно.

5. Выберите класс хранения. Вы сможете изменить его позже.

6. Нажмите кнопку Создать бакет.

1. Добавьте объект:

   1. Перейдите в личный кабинет VK Cloud.
   2. Выберите проект, где находится созданный бакет.
   3. Перейдите в раздел Object Storage → Бакеты.
   4. Нажмите на имя созданного бакета.
   5. Нажмите кнопку Добавить файл.
   6. Убедитесь, что выбрана настройка ACL Private.
   7. Нажмите кнопку Выбрать файлы и выберите файл, который нужно загрузить в бакет.

2. Предоставьте доступ к загруженному объекту по временной подписанной ссылке:

   1. Сгенерируйте временную ссылку для доступа к объекту с приватными настройками ACL, выполнив команду:

       
      aws s3 presign s3://<ИМЯ_БАКЕТА>/<КЛЮЧ_ОБЪЕКТА> --endpoint-url https://hb.ru-msk.vkcloud-storage.ru

      Здесь:

      • <ИМЯ_БАКЕТА> — имя бакета, в который загружен файл.
      • <КЛЮЧ_ОБЪЕКТА> — ключ объекта. В этом сценарии ключ совпадает с именем загруженного объекта.
      Пример

   2. Сохраните сгенерированную временную ссылку.

      Ссылка имеет следующий вид:

       
      https://hb.ru-msk.vkcloud-storage.ru/<ИМЯ_БАКЕТА>/...?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...%2F...%2Fru-msk%2Fs3%2Faws4_request&X-Amz-Date=...&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=...

1. Добавьте объект:

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

2. Предоставьте доступ к загруженному объекту по прямой ссылке:

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

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

   3. Перейдите в раздел Object Storage → Бакеты.

   4. Нажмите на имя созданного бакета.

   5. Нажмите для загруженного ранее объекта и выберите пункт Доступ к файлу.

   6. Сохраните сгенерированную прямую ссылку.

      Ссылка имеет следующий вид:

       
      https://<ИМЯ_БАКЕТА>.hb.ru-msk.vkcloud-storage.ru/...

1. Перейдите в браузере по сгенерированной временной ссылке. Должен загрузиться объект, добавленный ранее с приватными настройками ACL.

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

Бакет и загруженные в него объекты тарифицируются. Если они вам больше не нужны:

1. Удалите объекты.
2. Удалите бакет.