Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

Postman

Postman を設定して R2 を操作する方法を学びます。

最終更新 Markdown で表示Agent セットアップ

Postman は、API とのやり取りを簡単にする API プラットフォームです。このガイドでは、認証済みの R2 リクエストでバケットを作成し、新しいオブジェクトをアップロードし、そのオブジェクトを取得する手順を説明します。R2 の Postman collection ↗ には、プラットフォームがサポートする操作の一覧があります。

1. R2 を購入する

このガイドは、Cloudflare アカウントを作成し、R2 を購入済みであることを前提とします。

2. Postman で R2 を確認する

公開されている R2 の Postman collection ↗ を確認します。コレクションは、バケットレベルの操作をまとめた Buckets フォルダーと、オブジェクトレベルの操作をまとめた Objects フォルダーに分かれています。Objects > Upload フォルダーの操作で、R2 に新しいオブジェクトを追加できます。

3. R2 の認証情報を設定する

Postman dashboard ↗ で Cloudflare R2 コレクションを選び、Variables タブを開きます。Variables では、R2 コレクション内の変数を設定できます。これらの変数は、R2 プラットフォームへの認証と操作に使います。変数を更新したら、必ず Save を選んでください。

基本的な操作を実行するには、Postman dashboard の Variables で account-id、r2-access-key-id、r2-secret-access-key を設定する必要があります。

手順は次のとおりです。

  1. Cloudflare ダッシュボードで R2 object storage ページを開きます。

    Overview を開く ↗

  2. R2 のダッシュボード右側にある Manage R2 API Tokens から、Cloudflare アカウント ID をコピーします。

  3. Postman dashboard ↗ に戻ります。

  4. account-id の CURRENT VALUE に Cloudflare アカウント ID を設定し、Save を選びます。

次に、R2 API トークンを生成します。

  1. Cloudflare ダッシュボードで R2 object storage ページを開きます。

    Overview を開く ↗

  2. 右側のサイドバーで Manage R2 API Tokens を選びます。

  3. Create API token を選びます。

  4. API 名の横にある鉛筆アイコンを選び、トークン名を Postman にし、Edit 権限を付与します。

このトークンと Access Key ID、Secret Access Key は厳重に管理してください。この手順のあと、これらの値を再表示することはできません。この情報を持つ人は、すべてのバケットを完全に操作できます。

Cloudflare ダッシュボードで API トークンを作成したあと、次の手順を行います。

  1. Postman dashboard ↗ の Variables を開きます。
  2. Cloudflare ダッシュボードの Access Key ID の値をコピーし、Postman の r2-access-key-id 変数に貼り付けて Save を選びます。
  3. Cloudflare ダッシュボードの Secret Access Key の値をコピーし、Postman の r2-secret-access-key 変数に貼り付けて Save を選びます。

ここまでで、Postman に account-id、r2-secret-access-key、r2-access-key-id が設定されているはずです。

トークンを確認する手順は次のとおりです。

  1. Postman dashboard で、Cloudflare R2 フォルダーのドロップダウン矢印 > Buckets フォルダーのドロップダウン矢印 > GETListBuckets を選びます。
  2. Send を選びます。

Postman collection は、ハンドシェイクに AWS SigV4 認証を使います。

200 OK レスポンスと、既存バケットの一覧が表示されます。エラーになる場合は、R2 のサブスクリプションが有効であることと、Postman の変数が正しく保存されていることを確認してください。

4. バケットを作成する

Postman dashboard での手順は次のとおりです。

  1. Variables を開きます。
  2. r2-bucket 変数の値に R2 バケット名を設定し、Save を選びます。
  3. Cloudflare R2 フォルダーのドロップダウン矢印 > Buckets フォルダーのドロップダウン矢印 > PUTCreateBucket を選び、Send を選びます。

200 OK レスポンスが表示されます。ListBuckets リクエストを再度実行すると、結果一覧にバケットが現れます。

5. オブジェクトを追加する

バケットにオブジェクトを追加します。

  1. Postman dashboard の Variables を開きます。
  2. r2-object を cat-pic.jpg に設定し、Save を選びます。
  3. Cloudflare R2 フォルダーのドロップダウン矢印 > Objects フォルダーのドロップダウン矢印 > Multipart フォルダーのドロップダウン矢印 > PUTPutObject を選び、Send を選びます。
  4. Body を開き、binary を選んでから、猫の写真を添付します。
  5. Send を選んで、猫の写真を R2 バケットに追加します。

数秒後に 200 OK レスポンスが返ります。

6. オブジェクトを取得する

GetObject リクエストを使えば、あと数回のクリックで猫の写真をダウンロードできます。

  1. Cloudflare R2 フォルダーのドロップダウン矢印 > Objects フォルダーのドロップダウン矢印 > GETGetObject を選びます。
  2. Send を選びます。

R2 チームは、機能セットの拡充に合わせて、このコレクションを更新し続けます。ほかの操作も試して、R2 Postman collection の残りを確認できます。

役に立ちましたか？