GetObject

Prev Next

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

컨테이너(버킷)의 오브젝트를 다운로드하고 메타데이터를 조회합니다.
응답 헤더를 통해 오브젝트 메타데이터를 확인하고, 응답 바디를 통해 오브젝트 내용을 다운 받습니다.
대용량 오브젝트인 경우, 응답 바디는 세그먼트 오브젝트의 연결 내용이 포함됩니다.

요청

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

메서드 URI
GET /v1/AUTH_{project_id}/{container}/{object}

요청 헤더

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

필드 타입 필수 여부 설명
X-Auth-Token String Optional 발급한 토큰 값
X-Newest Boolean Optional 가장 최근 복제본의 정보로 응답할지 여부를 설정
  • true | false
    • true: 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
  • 헤더가 생략된 경우, 응답이 가장 빠른 정보로 응답
Range String Optional 대상 오브젝트의 범위 지정
  • Bytes=-5: 마지막 5 바이트
  • Bytes=10-15: 10 바이트부터 15 바이트까지의 6 바이트
  • Bytes=10-15,-5: 10 바이트부터 15 바이트까지의 6 바이트와 마지막 5 바이트를 함께 응답, Content-Type 헤더를 multipart/byteranges로 응답
  • Bytes=6-: 6 바이트부터 마지막까지
  • Bytes=1-3,2-5: 1 바이트부터 3 바이트까지의 3 바이트와 2 바이트부터 5 바이트까지의 3 바이트를 함께 응답, Content-Type 헤더를 multipart/byteranges로 응답
If-Match String Optional ETag 조건 헤더
  • 자세한 내용은 RFC2616에서 확인
If-None-Match String Optional ETag 조건 헤더
  • 자세한 내용은 RFC2616에서 확인
If-Modified-Since String Optional Last-Modified 조건 헤더
  • 자세한 내용은 RFC2616에서 확인
If-Unmodified-Since String Optional Last-Modified 조건 헤더
  • 자세한 내용은 RFC2616에서 확인

요청 경로 파라미터

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

필드 타입 필수 여부 설명
project_id String Required 프로젝트 ID
container String Required 컨테이너(버킷) 이름
object String Required 오브젝트 이름

요청 쿼리 파라미터

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

필드 타입 필수 여부 설명
temp_url_sig String Required 저장할 리소스에 접근할 수 있는 임시 URL의 서명
  • 승인된 요청임을 검증
temp_url_expires Integer Required 저장할 리소스에 접근할 수 있는 임시 URL의 만료 시간(Unix Timestamp)
filename String Conditional 오브젝트를 저장할 위치 및 파일 이름
multipart-manifest String Conditional 대용량 오브젝트의 멀티파트 업로드 선언
  • Static 대용량 오브젝트에 대한 매니페스트를 가져올 때 사용
  • 값으로 put을 입력하면 멀티파트 업로드로 인식되어 파트를 한 파일로 조합하도록 서버에 지시
  • 요청 바디에 파트 조합에 대한 매니페스트를 작성해야 함

요청 예시

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

curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}" 
-H "X-Auth-Token: $token"

응답

응답 형식을 설명합니다.

응답 헤더

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

필드 타입 필수 여부 설명
Content-Type String - 응답 결과의 MIME 타입
ETag String - ETag 헤더 값
Last-Modified String - 오브젝트의 가장 최근 수정 시간(UTC)
X-Timestamp Integer - 오브젝트가 생성된 시각(Unix Timestamp)
Accept-Ranges String - 해당 오브젝트가 허용하는 범위 유형
Content-Length String - 응답 결과의 길이(Byte)
X-Trans-Id String - 해당 요청의 트랜잭션 ID
X-Openstack-Request-Id String - 해당 요청의 트랜잭션 ID
  • X-Trans-Id와 동일
X-Object-Meta-{name} String - 설정할 메타데이터
  • {name} 부분에 메타데이터의 키 입력
  • 헤더 값에 메타데이터 값 입력
Content-Disposition String - 브라우저의 응답 처리 방식
Content-Encoding String - 오브젝트의 인코딩 방식
X-Delete-At Integer - 오브젝트의 자동 삭제 예정 시각(Unix Timestamp)
  • 데이터를 일시적으로 저장하기 원할 때 사용
  • 입력된 일시에 오브젝트 삭제
X-Object-Manifest String - 대용량 오브젝트를 업로드할 경우 오브젝트(SLO)의 매니페스트
  • 포맷: {container}/{prefix}
Date String - 해당 요청의 응답 시간(UTC)
X-Static-Large-Object Boolean - 대용량 오브젝트(SLO) 여부
  • true | false

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
200 - OK 요청 성공
206 - Partial Content Range 파라미터를 통해 오브젝트 내용 일부분의 요청 성공
403 - Not Found 컨테이너(버킷)가 존재하지 않음

응답 예시

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

HTTP/1.1 200 OK
Content-Length: 210012
Accept-Ranges: bytes
Last-Modified: Tue, 11 Sep 2018 02:12:30 GMT
Etag: 9bd5b4f25faf491080654a34d57c3636
X-Timestamp: 1536631949.99141
Content-Type: text/plain
X-Trans-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
X-Openstack-Request-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
Date: Wed, 12 Sep 2018 05:10:15 GMT