AWS S3 API
    • PDF

    AWS S3 API

    • PDF

    Article Summary

    Classic/VPC 환경에서 이용 가능합니다.

    AWS S3에서 제공하는 API를 이용하여 네이버 클라우드 플랫폼의 Archive Storage를 사용하는 예제입니다. 이 가이드에서는 Amazon S3 v2006-03-01 버전을 기준으로 설명합니다.

    참고
    • S3 API는 기본적인 기능만 지원하므로 제한적인 용도(Get/Listing)로만 사용할 것을 권장합니다. 이 가이드에서 안내하는 다른 SDK나 콘솔을 사용하면 더 안정적인 환경에서 Archive Storage를 사용할 수 있습니다.
    • 대용량 오브젝트 관리 시 S3 API가 불안정하게 동작할 수 있습니다. 대용량 오브젝트를 관리해야 할 경우에는 대용량 파일 관리를 참조해 주십시오.

    호출 도메인(Endpoint)

    HTTP/HTTPS 프로토콜을 모두 지원하지만 데이터 보호를 위해 HTTPS 프로토콜을 사용할 것을 권장합니다.

    리전별 호출 도메인은 다음과 같습니다.

    리전리전 이름호출 도메인
    한국krhttps://kr.archive.ncloudstorage.com
    참고

    리전 이름은 소문자로 입력해야 합니다.

    인증키(Credential)

    네이버 클라우드 플랫폼 포털에서 생성한 API 인증키를 사용합니다. API 인증키 정보에서 Access Key ID는 user name, Secret Key는 user password로 사용합니다.

    참고

    오퍼레이션

    네이버 클라우드 플랫폼의 Archive Storage에서는 일부 S3 API 만 제공합니다. 지원하는 오퍼레이션은 다음과 같습니다.

    계정 관련 오퍼레이션

    계정 레벨에서는 해당 계정에 속한 버킷 목록을 조회하는 오퍼레이션만 지원합니다.
    계정 관련 오퍼레이션은 다음과 같습니다.

    오퍼레이션설명
    GET account계정에 속한 버킷 목록 조회

    버킷 오퍼레이션

    버킷을 생성, 삭제, 조회, 제어하는 오퍼레이션은 다음과 같습니다.

    오퍼레이션설명
    DELETE Bucket빈 버킷 삭제
    GET Bucket버킷에 포함된 오브젝트 조회. 한 번에 최대 1,000개의 오브젝트가 나열됨
    HEAD Bucket버킷 헤더 조회
    GET multipart uploads완료되지 않았거나 취소된 멀티 파트 업로드 조회
    PUT Bucket버킷 생성. 계정당 버킷 개수는 1,000개로 제한
    참고

    버킷 내의 오브젝트 목록 조회 GET Bucket (List Objects) Version 2는 지원하지 않습니다.

    오브젝트 오퍼레이션

    오브젝트를 생성, 삭제, 조회, 제어하는 오퍼레이션은 다음과 같습니다.

    오퍼레이션설명
    DELETE Object버킷에서 오브젝트 삭제
    DELETE Multiple Objects버킷에서 멀티파트 오브젝트 삭제
    GET Object버킷에서 오브젝트 조회
    HEAD Object오브젝트 헤더 조회
    PUT Object버킷에 오브젝트 추가
    PUT Object (Copy)오브젝트 복사본 생성
    Initiate Multipart Upload업로드할 파트 집합에 지정할 업로드 ID 생성
    Upload Part업로드 ID와 연관된 오브젝트의 파트 업로드
    Upload Part (Copy)업로드 ID와 연관된 기존 오브젝트의 파트 업로드
    Complete Multipart Upload업로드 ID와 연관된 파트로 분리된 오브젝트 결합
    Abort Multipart Upload업로드를 중단하고 업로드 ID와 연관된 파트 삭제
    List Parts업로드 ID와 연관된 파트 목록 반환
    주의
    • Archive Storage에서 디렉터리(폴더) 오브젝트의 content-type은 application/directory를 사용합니다.
    • 디렉터리(폴더) 오브젝트의 이름 끝에 '/'를 사용하지 않을 것을 권장합니다.

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.