Примеры использования API Портала SberCloud для работы с Объектным хранилищем S3

Приводим описание нескольких операций с Объектным хранилищем, которые можно осуществить с помощью API-запросов.

Просмотр «Корзин» в составе Группы

Для выполнения этой операции вам потребуется универсальный идентификатор (UUID) Группы. Для его получения выполните следующие действия:

  1. Авторизуйтесь на Портале SberCloud с ролью Администратора Организации.

  2. В главном меню Портала нажмите на изображение шестеренки, расположенное рядом с названием Организации.

  3. В меню Все группы выберите Группу, список «Корзин» которой вам нужен.

  4. Скопируйте в буфер обмена ее UUID, нажав на изображение сдвоенных квадратиков.

Далее необходимо ввести полученные данные в API-клиент:

  1. В приложении Talend API Tester Free Edition в поле METHOD выберите значение GET.

  2. В поле для ввода URL введите https://portal.sbercloud.ru/api/v1/buckets/<UUID группы>.

  3. Нажмите на кнопку Send.

  4. В ответе на запрос будет отображен список «Корзин» Группы со всеми метаданными и служебной информацией.

Получение статистики использования «Корзины»

Для выполнения этой операции вам потребуется универсальный идентификатор (UUID) «Корзины». Для его получения выполните следующие действия:

  1. На Портале SberCloud войдите в меню Мои услуги → Корзины.

  2. Выберите в списке нужную «Корзину» и нажмите на ее строку.

  3. В открывшемся меню Информация найдите UUID и скопируйте его в буфер обмена.

Просмотр статистики за все время

  1. В приложении Talend API Tester Free Edition в поле METHOD выберите значение GET.

  2. В поле для ввода URL введите https://portal.sbercloud.ru/api/v1/buckets/UUID Корзины/statistics.

  3. Нажмите на кнопку Send.

  4. В ответе на запрос будет отображена статистика использования «Корзины» за весь период ее существования.

Просмотр статистики за заданный период

  1. В приложении Talend API Tester Free Edition в поле METHOD выберите значение GET.

  2. В поле для ввода URL введите https://portal.sbercloud.ru/api/v1/buckets/UUID Корзины/statistics.

  3. В меню QUERY PARAMETERS нажмите на кнопку Add query parameter.

  4. В поле name введите параметр start_date.

  5. В поле value введите значение 2020-04-19.

  6. Снова в меню QUERY PARAMETERS нажмите на кнопку Add query parameter.

  7. В поле name введите параметр end_date.

  8. В поле value введите значение 2020-04-21.

  9. Нажмите на кнопку Send.

  10. В ответе на запрос будет отображена статистика использования «Корзины» с 19 по 22 апреля 2020 года.

Изменение параметров «Корзины»

Выберите или создайте «Корзину», у которой отключен параметр Версионность.

Для проверки параметра Версионность выполните следующие действия:

  1. На Портале SberCloud войдите в меню Мои услуги → Корзины.

  2. Выберите в списке нужную «Корзину» и нажмите на ее строку.

  3. На открывшейся странице выберите пункт меню Конфигурация.

  4. Если параметр Версионность включен, отключите его, передвинув ползунок.

  5. Скопируйте UUID «Корзины» в буфер обмена (см. раздел «Получение статистики использования «Корзины»»).

  6. В приложении Talend API Tester Free Edition в поле METHOD выберите значение PATCH.

  7. В поле для ввода URL введите https://portal.sbercloud.ru/api/v1/buckets/UUID Корзины.

  8. В меню QUERY PARAMETERS нажмите кнопку Add query parameter.

  9. В поле name введите параметр versioning. В поле value введите значение true.

  10. Нажмите на кнопку Send.

  11. В ответе на запрос будет содержаться сообщение о включении для указанной «Корзины» параметра Версионность.

Удаление «Корзины»

  1. Скопируйте в буфер обмена UUID «Корзины», которую вы хотите удалить.

  2. В приложении Talend API Tester Free Edition в поле METHOD выберите значение DELETE.

  3. В поле для ввода URL введите https://portal.sbercloud.ru/api/v1/buckets/UUID Корзины.

  4. Нажмите на кнопку Send.

  5. В ответе на запрос будет содержаться сообщение об отсутствии указанной «Корзины», то есть о ее удалении.