Amazon S3 활용 가이드
Object Storage는 Samsung Cloud Platform Console을 통해 서비스 생성, 목록 조회, 폴더 리스트 조회, 폴더 생성, 파일 업로드, 다운로드 등과 같은 기능을 제공하고 있습니다. 또한 해당하는 기능들은 Amazon S3와 호환 가능한 API를 통해서도 제공하고 있습니다. 따라서 Amazon S3를 활용한 도구들을 동일하게 사용 가능합니다.
Amazon S3의 활용 도구를 사용하기 위해서는 인증키 생성 및 확인이 필요합니다. 자세한 사항은 인증키 생성하기를 참고하세요.
주의
Amazon S3 활용 도구 사용 시 다음 버전을 사용해야 합니다. 다른 버전을 사용할 경우에는 일부 기능이 제한될 수 있으므로 주의하세요.
- SDK v2: 2.22.x 이하
- SDK v1: 1.12.781 이하
- CLI v2: 2.22.x 이하
- CLI v1: 1.36.x 이하
- SDK for JavaScript v3 : 3.728.0 이하
- SDK for Python(Boto3) : 1.35.x 이하
Amazon S3 API
Samsung Cloud Platform Object Storage 서비스에서 지원하는 Amazon S3 API 목록은 아래와 같습니다.
참고
Amazon S3 API에 대한 자세한 내용은 Amazon S3 API 가이드를 확인하세요.
| 구분 | 상세 설명 |
|---|---|
| head-bucket | 버킷 정보 조회 |
| list-buckets | 버킷 목록 조회 |
| get-bucket-versioning | 버킷 버전관리 조회 |
| put-bucket-versioning | 버킷 버전관리 수정 |
| get-bucket-encryption | 버킷 암호화 설정 조회 |
| put-bucket-encryption | 버킷 암호화 설정 적용 |
| delete-bucket-encryption | 버킷 암호화 설정 삭제 |
| copy-object | 오브젝트 복사, 이동, 이름 변경 |
| put-object | 오브젝트 생성 |
| get-object | 오브젝트 다운로드 |
| list-objects | 오브젝트 목록 조회 |
| head-object | 오브젝트 상세 조회 |
| get-object-acl | 오브젝트 ACL 조회 |
| delete-object | 오브젝트 삭제
|
| list-object-versions | 오브젝트 버전 목록 조회 |
| delete-object | 오브젝트 버전 삭제 |
| presign | PUT 오브젝트 Presigned URL 발급 |
| get-bucket-acl | 버킷 퍼블릭 권한확인 |
| create-bucket | 버킷 생성 |
| delete-bucket | 버킷 삭제 |
| get-bucket-cors | 버킷 CORS (Cross OriginResources) configuration 확인 |
| put-bucket-cors | 버킷 CORS 생성 (PUT) |
| delete-bucket-cors | 버킷 CORS 삭제 |
| put-bucket-tagging | 버킷 tagging 생성 |
| get-bucket-tagging | 버킷 tagging 조회 |
| delete-bucket-tagging | 버킷 tagging 삭제 |
| put-bucket-website | 버킷 website 생성 |
| get-bucket-website | 버킷 website 조회 |
| delete-bucket-website | 버킷 website 삭제 |
| get-bucket-policy-status | 버킷 policy status 조회 |
| put-bucket-acl | 버킷 acl 생성 |
| create-multipart-upload | Multipart upload 생성 |
| upload-part | Multipart upload 수행 |
| complete-multipart-upload | Multipart upload 완료 |
| list-multipart-uploads | Multipart upload 목록 |
| abort-multipart-upload | 미완료 Multipart upload 삭제 |
| put-object-tagging | Object tagging 생성 |
| get-object-tagging | Object tagging 조회 |
| delete-object-tagging | Object tagging 삭제 |
| list-objects-V2 | Object 조회 (v2) |
| put-object-acl | Object acl 생성 |
| list-parts | Parts 조회 |
| put-public-access-block | Public access block 생성 |
| get-public-access-block | public access block 조회 |
| delete-public-access-block | public access block 삭제 |
| put-bucket-lifecycle | 버킷 Lifecycle 생성 (Expiration rule만 사용 가능) |
| get-bucket-lifecycle | 버킷 Lifecycle 조회 |
| delete-bucket-lifecycle | 버킷 Lifeyccycle 삭제 |
| put-bucket-replication | 버킷 복제 정책 수정
|
| get-bucket-replication | 버킷 복제 정책 조회 |
| delete-bucket-replication | 버킷 복제 정책 삭제 |
표. Amazon S3 지원 API 목록
Amazon S3 CLI
AWS CLI에서 Amazon S3 사용하기 위해서는 Amazon S3 CLI 가이드를 참고하세요.
Java용 Amazon S3 SDK
Java용 Amazon S3 SDK를 사용하기 위해서는 Amazon S3 SDK 가이드를 참고하세요.
참고
기타 언어에 대한 SDK 가이드 및 Rest API 가이드는 AWS 공식 홈페이지에서 확인하세요.
참고
- Amazon S3 SDK 사용하기 위해서 필요한 region 파라미터는 아래 참고하여 사용하세요.
- 한국 서부(kr-west1)인 경우: kr-west
- 한국 남부1,2,3(kr-south1,2,3)인 경우: kr-south
- region 파라미터는 참고용이며, 실제 region은 URL 기준으로 구분합니다.
참고
- 한국 남부3(kr-south3) 리전 제약 사항
- Samsung Cloud Platform Console을 통한 파일 업로드 및 다운로드 기능이 제한됩니다.
- Public URL을 이용한 S3 API/CLI 사용이 제한됩니다.
- 단, Samsung Cloud Platform Console에서 생성한 자원(Virtual Server 등)을 통한 Private URL 접근은 가능합니다.
- 한국 남부1(kr-south1), 한국 남부2(kr-south2) 리전 제약 사항
- Public URL 접근을 위해 별도 방화벽 설정을 허용해야 합니다.
- Public URL 주소는 Object Storage 상세 페이지에서 확인할 수 있습니다. Object Storage 상세 정보 확인하기를 참고하세요.