GetObject

인쇄
공유
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

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 프로젝트 ID 확인 방법은 Archive Storage 개요 참조
`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

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

What's Next

PutObject

요청
응답

태그

Archive Storage