API 개요
카카오클라우드 Object Storage API는 코드를 통해 버킷과 객체를 관리할 수 있는 인터페이스입니다. 콘솔에서 하기 번거로운 대량 작업이나 반복 작업을 자동화할 때 유용합니다.
- Swift API – OpenStack 표준 방식
- Extension API – 카카오클라우드에서 추가 제공하는 확장 기능
- S3 호환 API – AWS S3와 호환되는 방식
이 API들은 REST 방식을 기반으로 하며, 프로그램이나 스크립트에서 쉽게 사용할 수 있습니다.
시작하기 전에
API를 사용하기 전 엔드포인트, 역할 및 권한, 인증 정보를 확인·준비하면, 요청 오류를 줄이고 원활하게 API를 호출할 수 있습니다.
Endpoint
API 요청을 위한 kr-central-2리전 Object Storage API 엔드포인트 URL은 다음과 같습니다.
https://objectstorage.kr-central-2.kakaocloud.com
역할 및 권한
사용자의 IAM 역할과 Object Storage 역할에 따라 Object Storage 서비스에 권한을 가집니다.
IAM Object Storage 매니저, Object Storage 뷰어 역할은 버킷 생성 및 버킷 목록 조회 권한을 부여합니다. 또한, 대상 버킷에 Object Storage 역할 있는 사용자는 버킷 및 객체의 권한을 가집니다.
요약하자면, Object Storage API 호출은 작업 유형에 따라 필요한 권한이 다릅니다.
- 버킷 생성·목록 조회: IAM 역할(Object Storage 매니저 또는 뷰어)만 있으면 됩니다.
- 특정 버킷/객체 작업: 해당 버킷 권한만 있으면 됩니다.
IAM 역할과 버킷 역할의 자세한 내용은 역할 및 권한에서 확인할 수 있습니다.
인증(S3 액세스키, 사용자 인증 토큰(API 인증 토큰))
API를 호출하기 위해 필요한 사전 작업은 API 사용 준비 문서를 참고하시기 바랍니다.
S3 Access Key 발급
S3 API를 호출하기 위해서 S3 Access Key를 발급하여 AWS Signature의 Credential로 이용할 수 있습니다.
S3 Access Key는 서비스 계정과 사용자 계정으로 발급할 수 있습니다. 자세한 설명은 아래 가이드 링크를 통해서 확인해 주세요.