GetObject

개요

오브젝트 경로가 지정된 GET 요청을 전달하면 오브젝트를 다운로드합니다. 오퍼레이션에 사용되는 파라미터, 페이로드는 없습니다.

요청

구문

GET https://{endpoint}/{bucket-name}/{object-name} # path style
GET https://{bucket-name}.{endpoint}/{object-name} # virtual host style

헤더

헤더명 필수 여부 타입 제약 사항 설명
range No string 지정한 범위 내에서 오브젝트의 크기를 바이트 단위로 반환합니다.
if-match No string (ETag) 지정한 ETag 문자열이 소스 오브젝트와 일치하는 경우 오브젝트를 반환합니다.
if-none-match No string (ETag) 지정한 ETag 문자열이 소스 오브젝트와 다를 경우 오브젝트를 반환합니다.
if-unmodified-since No string (timestamp) 지정한 날짜 이후에 소스 오브젝트를 수정하지 않은 경우 오브젝트를 반환합니다. 유효한 날짜 형식이어야 합니다(예: Wed, 30 Nov 2016 20:21:38 GMT).
if-modified-since No string (timestamp) 지정한 날짜 이후에 소스 오브젝트를 수정한 경우 오브젝트를 반환합니다. 유효한 날짜 형식이어야 합니다(예: Wed, 30 Nov 2016 20:21:38 GMT).

예시

요청 예시

GET /example-bucket/worker-bee HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20160825T183244Z
Host: kr.object.ncloudstorage.com

응답 예시

HTTP/1.1 200 OK
Date: Thu, 25 Aug 2016 18:34:25 GMT
x-amz-request-id: 116dcd6b-215d-4a81-bd30-30291fa38f93
Accept-Ranges: bytes
ETag: "d34d8aada2996fc42e6948b926513907"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2016 17:46:53 GMT
Content-Length: 467

 Female bees that are not fortunate enough to be selected to be the 'queen'
 while they were still larvae become known as 'worker' bees. These bees lack
 the ability to reproduce and instead ensure that the hive functions smoothly,
 acting almost as a single organism in fulfilling their purpose.