Skip to content
ByoungSeob Kim edited this page Jul 19, 2025 · 1 revision

AWS S3 API 목록

버킷(Bucket) 관련 API

API 이름 HTTP 메서드 설명 엔드포인트
CreateBucket PUT 새로운 S3 버킷 생성 PUT /{bucket}
DeleteBucket DELETE 빈 버킷 삭제 DELETE /{bucket}
ListBuckets GET 계정의 모든 버킷 목록 조회 GET /
HeadBucket HEAD 버킷 존재 여부 및 접근 권한 확인 HEAD /{bucket}
GetBucketLocation GET 버킷의 리전 정보 조회 GET /{bucket}?location

객체(Object) 관련 API

API 이름 HTTP 메서드 설명 엔드포인트
PutObject PUT 객체를 버킷에 업로드 PUT /{bucket}/{key}
GetObject GET 버킷에서 객체 다운로드 GET /{bucket}/{key}
DeleteObject DELETE 버킷에서 객체 삭제 DELETE /{bucket}/{key}
HeadObject HEAD 객체 메타데이터 조회 HEAD /{bucket}/{key}
CopyObject PUT 객체를 다른 위치로 복사 PUT /{bucket}/{key}
ListObjects GET 버킷의 객체 목록 조회 (v1) GET /{bucket}
ListObjectsV2 GET 버킷의 객체 목록 조회 (v2) GET /{bucket}?list-type=2

멀티파트 업로드 관련 API

API 이름 HTTP 메서드 설명 엔드포인트
CreateMultipartUpload POST 멀티파트 업로드 시작 POST /{bucket}/{key}?uploads
UploadPart PUT 멀티파트 업로드의 파트 업로드 PUT /{bucket}/{key}?partNumber={n}&uploadId={id}
CompleteMultipartUpload POST 멀티파트 업로드 완료 POST /{bucket}/{key}?uploadId={id}
AbortMultipartUpload DELETE 멀티파트 업로드 취소 DELETE /{bucket}/{key}?uploadId={id}
ListParts GET 업로드된 파트 목록 조회 GET /{bucket}/{key}?uploadId={id}
ListMultipartUploads GET 진행 중인 멀티파트 업로드 목록 조회 GET /{bucket}?uploads

버킷 정책 및 ACL 관련 API

API 이름 HTTP 메서드 설명 엔드포인트
PutBucketPolicy PUT 버킷 정책 설정 PUT /{bucket}?policy
GetBucketPolicy GET 버킷 정책 조회 GET /{bucket}?policy
DeleteBucketPolicy DELETE 버킷 정책 삭제 DELETE /{bucket}?policy
PutBucketAcl PUT 버킷 ACL 설정 PUT /{bucket}?acl
GetBucketAcl GET 버킷 ACL 조회 GET /{bucket}?acl
PutObjectAcl PUT 객체 ACL 설정 PUT /{bucket}/{key}?acl
GetObjectAcl GET 객체 ACL 조회 GET /{bucket}/{key}?acl

버킷 설정 관련 API

API 이름 HTTP 메서드 설명 엔드포인트
PutBucketVersioning PUT 버킷 버저닝 설정 PUT /{bucket}?versioning
GetBucketVersioning GET 버킷 버저닝 상태 조회 GET /{bucket}?versioning
PutBucketCors PUT CORS 설정 PUT /{bucket}?cors
GetBucketCors GET CORS 설정 조회 GET /{bucket}?cors
DeleteBucketCors DELETE CORS 설정 삭제 DELETE /{bucket}?cors
PutBucketLifecycleConfiguration PUT 라이프사이클 정책 설정 PUT /{bucket}?lifecycle
GetBucketLifecycleConfiguration GET 라이프사이클 정책 조회 GET /{bucket}?lifecycle
DeleteBucketLifecycle DELETE 라이프사이클 정책 삭제 DELETE /{bucket}?lifecycle

웹사이트 호스팅 관련 API

API 이름 HTTP 메서드 설명 엔드포인트
PutBucketWebsite PUT 웹사이트 호스팅 설정 PUT /{bucket}?website
GetBucketWebsite GET 웹사이트 호스팅 설정 조회 GET /{bucket}?website
DeleteBucketWebsite DELETE 웹사이트 호스팅 설정 삭제 DELETE /{bucket}?website

태깅 및 메타데이터 관련 API

API 이름 HTTP 메서드 설명 엔드포인트
PutBucketTagging PUT 버킷 태그 설정 PUT /{bucket}?tagging
GetBucketTagging GET 버킷 태그 조회 GET /{bucket}?tagging
DeleteBucketTagging DELETE 버킷 태그 삭제 DELETE /{bucket}?tagging
PutObjectTagging PUT 객체 태그 설정 PUT /{bucket}/{key}?tagging
GetObjectTagging GET 객체 태그 조회 GET /{bucket}/{key}?tagging
DeleteObjectTagging DELETE 객체 태그 삭제 DELETE /{bucket}/{key}?tagging

기타 유용한 API

API 이름 HTTP 메서드 설명 엔드포인트
SelectObjectContent POST S3 Select를 사용하여 객체 내용 쿼리 POST /{bucket}/{key}?select&select-type=2
RestoreObject POST Glacier에서 객체 복원 POST /{bucket}/{key}?restore
PutBucketNotificationConfiguration PUT 이벤트 알림 설정 PUT /{bucket}?notification
GetBucketNotificationConfiguration GET 이벤트 알림 설정 조회 GET /{bucket}?notification

참고사항:

  • 모든 API는 AWS Signature Version 4로 인증이 필요합니다
  • 엔드포인트의 기본 URL은 https://s3.{region}.amazonaws.com 형식입니다
  • {bucket}, {key}, {id} 등은 실제 값으로 치환해야 합니다
  • 일부 API는 특정 리전에서만 사용 가능할 수 있습니다

Table of contents



Clone this wiki locally