객체 다운로드

객체를 다운로드합니다.

객체의 GET 요청에는 HTTP 1.1 RFC에 정의된 범위 헤더를 포함하여 객체 내 반환된 데이터의 범위를 제한할 수 있지만 특정 상황의 경우 101}범위 헤더는 무시됩니다.

압축 상태로 Cloud Storage에 저장된 객체는 특정 기준이 충족되면 다운로드 요청의 일부로 자동으로 압축 해제될 수 있습니다. 이 트랜스코딩 동작은 요청자가 객체를 압축 해제할 필요가 없습니다.

요청에는 If-Modified-Since 또는 If-Unmodified-Since 헤더가 포함될 수도 있습니다. 이 경우 객체가 지정된 타임스탬프 이후 수정되지 않았거나 수정된 경우 응답이 본문으로 생략됩니다. 객체가 If-Modified-Since 헤더 조건을 충족하지 않는 경우 응답은 304 Not Modified가 되고 객체가 If-Unmodified-Since 헤더 조건을 충족하지 못하면 {101입니다. }412 사전 조건 실패.

마찬가지로 요청에는 일치할 ETag와 If-Match 및 If-None-Match 헤더가 포함될 수 있습니다. 객체가 If-Match 헤더 조건과 일치하지 않으면 응답은 412 Precondition Failed이고 객체가 If-None-Match 헤더의 지정된 해시와 일치하면 응답은 304 Not{101입니다. }수정되었습니다.

객체를 다운로드하는 방법은 객체 다운로드 가이드를 참조하세요.

쿼리 문자열 매개변수

매개변수 설명 필수
generation 특정 객체 버전을 가져오려는 경우에 사용할 수 있습니다. 없음

서명된 URL을 만들고 사용할 때 포함되는 매개변수에 대한 정보는 서명된 URL 쿼리 문자열 매개변수를 참조하세요.

요청 헤더

공통 요청 헤더 외에도 다음을 사용할 수 있습니다.

헤더 설명 필수
If-Match 항목 태그 (ETag). 지정한 ETag가 객체의 ETag와 동일한 경우 객체가 다운로드됩니다. 없음
If-Modified-Since 날짜 및 시간. 지정한 날짜 및 시간보다 이후 객체가 수정된 경우 객체가 다운로드됩니다. 없음
If-None-Match 항목 태그 (ETag). 지정한 ETag가 객체의 ETag와 다르면 객체가 다운로드됩니다. 없음
If-Unmodified-Since 날짜 및 시간. 지정한 날짜 이후에 객체가 수정되지 않은 경우 객체가 다운로드됩니다. 없음
Range 다운로드할 객체의 범위 (바이트)입니다.

경고: Cloud Storage에서 데이터를 다운로드할 때 반환되는 체크섬은 전체 객체 콘텐츠를 대상으로 합니다. 따라서 요청 범위를 지정하면 해당 바이트 범위에 대해서만 데이터 손상을 감지할 방법이 없습니다. 따라서 마지막 수신 오프셋 이후에 전체 객체 다운로드를 다시 시작하는 경우에만 범위 요청을 사용하는 것이 좋습니다. 이 경우에는 전체 다운로드가 완료되면 체크섬을 계산하고 유효성을 검사할 수 있습니다.

없음

고객 제공 암호화 키로 암호화된 객체를 다운로드하려면 요청에 암호화 페이지에 나열된 헤더를 사용합니다.

요청 본문 요소

이 요청은 요청 본문에 XML 문서를 포함하지 않습니다.

요청 구문

acl 쿼리 문자열 매개변수를 사용하지 않는 GET 객체 요청에는 다음 구문이 적용됩니다.

GET /OBJECT_NAME HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Content-Length: 0
Authorization: AUTHENTICATION_STRING
Range: bytes=BYTE_RANGE
If-Match: ENTITY_TAG
If-Modified-Since: DATE
If-None-Match: ENTITY_TAG
If-Unmodified-Since: DATE

응답 헤더

이 요청은 Cache-Control, Content-Length를 비롯하여 사용하는 요청 헤더에 따라 다양한 응답 헤더를 반환할 수 있습니다. Content-Type, Content-Disposition, ETag, Last-Modified.

응답 본문 요소

응답에는 객체 데이터가 포함됩니다.

다음 예시에서는 travel-maps라는 버킷에 있는 paris.jpg라는 객체를 다운로드합니다.

요청

GET /paris.jpg HTTP/1.1
Host: travel-maps.storage.googleapis.com
Content-Length: 0
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

응답

HTTP/1.1 200 OK
Content-Type: image/jpg
Last-Modified: Fri, 19 Feb 2010 22:13:49 GMT
ETag: "2281880ef78388266ecd7d4c1b472a0e"
Content-Length: 328
Date: Fri, 19 Feb 2010 22:13:49 GMT

328 bytes of data...