← Cloudflare R2 / r2 / tutorials

Postman

Postman: платформа, упрощающая работу с API. В этом руководстве показано, как с её помощью отправлять аутентифицированные запросы к R2 для создания бакета, загрузки нового объекта и его последующего получения. R2 Коллекция Postman ↗ включает полный список операций, поддерживаемых платформой.

В этом руководстве предполагается, что у вас уже есть аккаунт Cloudflare и вы приобрели R2.

Изучите общедоступные Коллекция Postman ↗. Коллекция организована в Buckets папка для операций на уровне bucket и Objects папка для операций на уровне объекта. Операции в Objects > Upload папка позволяет добавлять новые объекты в R2.

В Панель Postman ↗, выберите Cloudflare R2 коллекцию и перейдите в Переменные вкладку. В Переменные, вы можете задать переменные внутри коллекции R2. Они будут использоваться для аутентификации и работы с платформой R2. Не забывайте всегда выбирать Save после обновления переменной.

Чтобы выполнять базовые операции, необходимо задать account-id, r2-access-key-id, а также r2-secret-access-key переменные в панели Postman > Переменные.

Для этого:

1. На панели управления Cloudflare перейдите к разделу Объектное хранилище R2 страницу.

   Перейдите в Обзор ↗

2. В R2, в разделе Управление API-токенами R2 в правой части панели управления скопируйте свой Cloudflare account ID.

3. Вернуться к Панель Postman ↗.

4. Задайте ТЕКУЩЕЕ ЗНАЧЕНИЕ account-id к вашему Cloudflare account ID и выберите Save.

Далее создайте API-токен R2:

1. На панели управления Cloudflare перейдите к разделу Объектное хранилище R2 страницу.

   Перейдите в Обзор ↗

2. В правой боковой панели выберите Управление API-токенами R2.

3. Выберите Создание API-токена.

4. Присвойте имя своему токену Postman выбрав значок карандаша рядом с именем API, и предоставьте ему Изменить разрешение.

Бережно храните этот токен и Access Key ID и Secret Access Key внимательно. После завершения этого шага вы не сможете снова просмотреть эти значения. Любой, кто получит эту информацию, сможет полностью управлять всеми вашими бакетами.

После создания API-токена в панели управления Cloudflare:

1. Перейдите в Панель Postman ↗ > Переменные.
2. Скопируйте Access Key ID значение из панели управления Cloudflare и вставьте его в r2-access-key-id значение переменной и выберите Save.
3. Скопируйте Secret Access Key значение из панели управления Cloudflare и вставьте его в r2-secret-access-key значение переменной и выберите Save.

К этому моменту у вас уже должны быть account-id, r2-secret-access-key, а также r2-access-key-id настроен в Postman.

Чтобы проверить токен:

1. В панели Postman выберите Cloudflare R2 папка, стрелка раскрывающегося списка > Buckets папка, стрелка раскрывающегося списка > GETListBuckets.
2. Выберите Отправить.

Коллекция Postman использует аутентификацию AWS SigV4 для завершения проверки подлинности.

Вы должны увидеть 200 OK ответ со списком существующих бакетов. Если вы получаете ошибку, убедитесь, что подписка R2 активна и переменные Postman сохранены правильно.

В панели Postman:

1. Перейдите в Переменные.
2. Задайте r2-bucket значение переменной в качестве имени вашего бакета R2 и выберите Save.
3. Выберите Cloudflare R2 папка, стрелка раскрывающегося списка > Buckets папка, стрелка раскрывающегося списка > PUTCreateBucket и выберите Отправить.

Вы должны увидеть 200 OK ответ. Если вы выполните ListBuckets запрос снова, ваш бакет появится в списке результатов.

Теперь добавьте объект в свой бакет:

1. Перейдите в Переменные в панели управления Postman.
2. Задайте r2-object к cat-pic.jpg и выберите Save.
3. Выберите Cloudflare R2 папка, стрелка раскрывающегося списка > Объекты папка, стрелка раскрывающегося списка > Составная загрузка папка, стрелка раскрывающегося списка > PUTPutObject и выберите Отправить.
4. Перейдите в Тело и выберите двоичный перед тем как прикрепить изображение кота.
5. Выберите Отправить чтобы добавить изображение кота в ваш бакет R2.

Через несколько секунд вы должны получить 200 OK ответ.

Скачать нашего любимого кота осталось всего на пару кликов больше с помощью GetObject запрос.

1. Выберите Cloudflare R2 папка, стрелка раскрывающегося списка > Объекты папка, стрелка раскрывающегося списка > GETGetObject.
2. Выберите Отправить.

Команда R2 будет поддерживать эту коллекцию в актуальном состоянии по мере расширения набора функций R2. Вы можете изучить остальную часть коллекции Postman для R2, опробовав другие операции.