GetObject

Prev Next

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

Ncloud Storage 버킷에 저장된 객체를 조회합니다.

참고
  • Deep Archive Class 객체는 복원이 완료된 경우에만 조회할 수 있습니다. 복원하지 않았거나 복원이 진행 중이면 403 InvalidObjectState를 반환합니다.
  • 객체의 메타데이터는 복원 여부와 관계없이 HeadObject로 조회할 수 있습니다.
  • 객체 복원은 RestoreObject를 참조해 주십시오.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET /{Key}

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오.

필드 필수 여부 설명
Range Optional 조회 범위(Byte)
x-amz-server-side-encryption-customer-algorithm Optional 사용자 암호화 알고리즘 (AES256)
x-amz-server-side-encryption-customer-key Optional 사용자 제공 암호화 키
x-amz-server-side-encryption-customer-key-MD5 Optional 사용자 제공 암호화 키의 MD5 값

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
Key String Required 객체 이름

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
partNumber String Optional 객체 파트 번호
  • ListParts 참조
  • 객체의 일부 파트만 조회하는 경우, 입력
versionId String Optional 객체 버전 아이디
  • ListObjectVersions 참조
  • 버전 관리가 설정된 버킷에서 객체의 특정 버전을 조회하는 경우, 입력

요청 예시

요청 예시는 다음과 같습니다.

GET /object.csv HTTP/1.1
Host: bucket.kr.ncloudstorage.com

응답

응답 형식을 설명합니다.

응답 헤더

응답 헤더에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 응답 헤더를 참조해 주십시오.

필드 필수 여부 설명
x-amz-object-lock-mode - 객체 보존 모드
  • GOVERNANCE | COMPLIANCE
  • 객체에 보존이 설정된 경우에 표시
x-amz-object-lock-retain-until-date - 객체 보존 만료일
  • ISO 8601 형식
  • 객체에 보존이 설정된 경우에 표시
x-amz-object-lock-legal-hold - 법적 보존 상태
  • ON | OFF
  • 객체에 법적 보존이 설정된 경우에 표시
x-amz-storage-class - 스토리지 클래스
  • ONEZONE_IA | DEEP_ARCHIVE
  • 객체가 Standard Class가 아닌 경우에 표시
x-amz-restore - 객체 복원 상태
  • ongoing-request="false", expiry-date="복원 만료 시간"
  • expiry-date: 복원 만료 시간(GMT 기준)
  • Deep Archive Class 객체의 복원이 완료된 경우에 표시

응답 상태 코드

Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Storage 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

HTTP/1.1 200 OK

<object data>