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 仪表板中，前往 R2 object storage（R2 对象存储） 页面。
Go to Overview ↗ -
在 R2 中，在仪表板右侧的 Manage R2 API Tokens（管理 R2 API 令牌） 下，复制您的 Cloudflare 账户 ID。
-
返回 Postman 仪表板 ↗。
-
将
account-id的 CURRENT VALUE（当前值） 设置为您的 Cloudflare 账户 ID 并选择 Save（保存）。
接下来，生成 R2 API 令牌：
-
在 Cloudflare 仪表板中，前往 R2 object storage（R2 对象存储） 页面。
Go to Overview ↗ -
在右侧边栏中，选择 Manage R2 API Tokens（管理 R2 API 令牌）。
-
选择 Create API token（创建 API 令牌）。
-
通过选择 API 名称旁边的铅笔图标将令牌命名为 Postman，并授予 Edit（编辑） 权限。
请妥善保管此令牌以及 Access Key ID（访问密钥 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 集合的其余部分。