본문으로 바로가기 본문 바로가기
WIKI 기술 지식 베이스

Postman

원문 보기 위키 갱신

Postman을 구성해서 R2와 상호작용하는 방법을 알아봐요.

Postman은 API와의 상호작용을 더 쉽게 만들어 주는 API 플랫폼이에요. 이 가이드에서는 Postman으로 인증된 R2 요청을 보내 버킷을 만들고, 새 객체를 업로드하고, 그 객체를 가져오는 방법을 설명해 드릴게요. R2 Postman 컬렉션 ↗︎에는 플랫폼이 지원하는 전체 작업 목록이 포함되어 있어요.

출처: 문서

본문

1. R2 구매

이 가이드는 Cloudflare 계정을 만들고 R2를 구매했다고 가정해요.

2. Postman에서 R2 살펴보기

R2의 공개 Postman 컬렉션 ↗︎을 살펴보세요. 컬렉션은 버킷 수준 작업을 위한 Buckets 폴더와 객체 수준 작업을 위한 Objects 폴더로 구성되어 있어요. Objects > Upload 폴더의 작업으로 R2에 새 객체를 추가할 수 있어요.

3. R2 자격 증명 구성

Postman 대시보드 ↗︎에서 Cloudflare R2 컬렉션을 선택하고 Variables 탭으로 이동해요. Variables에서 R2 컬렉션 안의 변수를 설정할 수 있어요. 이 변수들은 R2 플랫폼에 인증하고 상호작용하는 데 사용돼요. 변수를 업데이트한 후에는 항상 Save를 선택하는 것을 잊지 마세요.

기본 작업을 수행하려면 Postman 대시보드 > 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 대시보드 ↗︎로 돌아가요.
  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 대시보드 ↗︎ > 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 대시보드에서 Cloudflare R2 폴더 드롭다운 화살표 > Buckets 폴더 드롭다운 화살표 > GETListBuckets를 선택해요.
  2. Send를 선택해요.

Postman 컬렉션은 인증 핸드셰이크를 완료하기 위해 AWS SigV4 인증을 사용해요.

기존 버킷 목록과 함께 200 OK 응답이 표시돼야 해요. 오류가 발생하면 R2 구독이 활성 상태인지, Postman 변수가 올바르게 저장되었는지 확인해 주세요.

4. 버킷 만들기

Postman 대시보드에서:

  1. Variables로 이동해요.
  2. r2-bucket 변수 값을 R2 버킷의 이름으로 설정하고 Save를 선택해요.
  3. Cloudflare R2 폴더 드롭다운 화살표 > Buckets 폴더 드롭다운 화살표 > PUTCreateBucket을 선택하고 Send를 눌러요.

200 OK 응답이 표시돼야 해요. ListBuckets 요청을 다시 실행하면 버킷이 결과 목록에 나타날 거예요.

5. 객체 추가

이제 버킷에 객체를 추가해 볼게요:

  1. Postman 대시보드에서 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의 기능 세트가 확장됨에 따라 이 컬렉션을 최신 상태로 유지할 거예요. 다른 작업을 실험해 보면서 R2 Postman 컬렉션의 나머지 부분도 살펴볼 수 있어요.

더 알아보기 (Learn more)