Postman
R2と対話するためのPostmanの設定方法を学びます。
Postmanは、APIと対話するためのプラットフォームで、APIとのやり取りを容易にします。このガイドでは、Postmanを使用して認証されたR2リクエストを行い、バケットを作成し、新しいオブジェクトをアップロードし、その後オブジェクトを取得する方法を説明します。R2のPostmanコレクション ↗には、プラットフォームがサポートする操作の完全なリストが含まれています。
このガイドでは、Cloudflareアカウントを作成し、R2を購入したことを前提としています。
R2の公開されているPostmanコレクション ↗を探索します。このコレクションは、バケットレベルの操作用のBucketsフォルダーと、オブジェクトレベルの操作用のObjectsフォルダーに整理されています。Objects > Uploadフォルダー内の操作では、R2に新しいオブジェクトを追加できます。
Postmanダッシュボード ↗で、Cloudflare R2コレクションを選択し、Variablesタブに移動します。Variablesでは、R2コレクション内の変数を設定できます。これらはR2プラットフォームとの認証と対話に使用されます。変数を更新した後は、必ずSaveを選択してください。
基本的な操作を実行するには、PostmanダッシュボードのVariablesでaccount-id、r2-access-key-id、r2-secret-access-keyの変数を設定する必要があります。
これを行うには：
- Cloudflareダッシュボード ↗にログインします。
- Account HomeでR2を選択します。
- R2の右側のダッシュボードでManage R2 API Tokensの下にあるCloudflareアカウントIDをコピーします。
- Postmanダッシュボード ↗に戻ります。
account-idのCURRENT VALUEをCloudflareアカウントIDに設定し、Saveを選択します。
次に、R2 APIトークンを生成します：
- Cloudflareダッシュボード > R2に移動します。
- 右側のサイドバーでManage R2 API Tokensを選択します。
- Create API tokenを選択します。
- API名の横にある鉛筆アイコンを選択してトークンにPostmanという名前を付け、Edit権限を付与します。
このトークンとAccess Key ID、Secret Access Keyを厳重に保管してください。このステップを完了した後は、これらの値を再確認することはできません。この情報を持つ人は、あなたのすべてのバケットと完全に対話できます。
CloudflareダッシュボードでAPIトークンを作成した後：
- Postmanダッシュボード ↗ > Variablesに移動します。
- Cloudflareダッシュボードから
Access Key IDの値をコピーし、Postmanのr2-access-key-id変数の値に貼り付けてSaveを選択します。 - Cloudflareダッシュボードから
Secret Access Keyの値をコピーし、Postmanのr2-secret-access-key変数の値に貼り付けてSaveを選択します。
これで、Postmanにaccount-id、r2-secret-access-key、r2-access-key-idが設定されているはずです。
トークンを確認するには：
- Postmanダッシュボードで、Cloudflare R2フォルダのドロップダウン矢印 > Bucketsフォルダのドロップダウン矢印 >
GETListBucketsを選択します。 - Sendを選択します。
Postmanコレクションは、AWS SigV4認証を使用してハンドシェイクを完了します。
200 OKのレスポンスとともに既存のバケットのリストが表示されるはずです。エラーが表示された場合は、R2のサブスクリプションがアクティブであり、Postmanの変数が正しく保存されていることを確認してください。
Postmanダッシュボードで：
- Variablesに移動します。
r2-bucketの変数値をR2バケットの名前に設定し、Saveを選択します。- Cloudflare R2フォルダのドロップダウン矢印 > Bucketsフォルダのドロップダウン矢印 >
PUTCreateBucketを選択し、Sendを選択します。
200 OKのレスポンスが表示されるはずです。ListBucketsリクエストを再度実行すると、バケットが結果のリストに表示されます。
これからバケットにオブジェクトを追加します：
- PostmanダッシュボードのVariablesに移動します。
r2-objectをcat-pic.jpgに設定し、Saveを選択します。- Cloudflare R2フォルダのドロップダウン矢印 > Objectsフォルダのドロップダウン矢印 > Multipartフォルダのドロップダウン矢印 >
PUTPutObjectを選択し、Sendを選択します。 - Bodyに移動し、binaryを選択してから猫の写真を添付します。
- Sendを選択して、猫の写真をR2バケットに追加します。
数秒後に200 OKのレスポンスが返されるはずです。
GetObjectリクエストを使用して、私たちの猫の友達をダウンロードするには、あと数回のクリックで済みます。
- Cloudflare R2フォルダのドロップダウン矢印 > Objectsフォルダのドロップダウン矢印 >
GETGetObjectを選択します。 - Sendを選択します。
R2チームは、R2の機能セットを拡張するにつれて、このコレクションを最新の状態に保ちます。他の操作を試して、残りのR2 Postmanコレクションを探索できます。