GetObject
최신 업데이트：2025-08-18 15:52:04
객체가 저장된 버킷의 소유자는 GET 연산을 수행할 수 있습니다. 응답에는 객체의 콘텐츠와 메타데이터가 모두 포함됩니다.
요청 문법
GET /ObjectName?response-cache-control=ResponseCacheControl&response-content-disposition=ResponseContentDisposition&response-content-encoding=ResponseContentEncoding&response-content-language=ResponseContentLanguage&response-content-type=ResponseContentType&response-expires=ResponseExpires HTTP/1.1
Host: Bucket.Endpoint
Date: date
Authorization: authorization
URI 요청 파라미터
객체를 조회할 때, 요청 파라미터로 응답 헤더를 재정의할 수 있습니다. 재정의 가능한 헤더는 다음과 같습니다: Content-Type, Expires, Content-language, Cache-Control, Content-Disposition, Content-Encoding.
| 파라미터 | 설명 | 필수 여부 |
|---|---|---|
| response-content-type | 응답의 Content-Type 헤더를 재정의합니다. Content-Type에 따라 사용자에게 다른 방식으로 보여집니다. 기본값은 text/html(즉, 웹페이지)입니다. 예시: text/html;charset=utf-8.타입: String |
아니오 |
| response-expires | 응답의 Expires 헤더를 재정의합니다. 브라우저 캐시 만료 시간을 지정합니다. 타입: String |
아니오 |
| response-content-language | 응답의 Content-Language 헤더를 재정의합니다. 타입: String |
아니오 |
| response-cache-control | 응답의 Cache-Control 헤더를 재정의합니다. 웹 페이지의 캐싱을 제어하며, 주로 private, no-cache, max-age, must-revalidate 등이 있습니다. 기본값은 private입니다. 타입: String |
아니오 |
| response-content-disposition | 응답의 Content-Disposition 헤더를 재정의합니다. 사용자가 요청한 내용을 파일로 저장할 때 기본 파일명을 지정합니다. 예시: attachment; filename="cool.html" 타입: String |
아니오 |
| response-content-encoding | 응답의 Content-Encoding 헤더를 재정의합니다. 예시: gzip, deflate 타입: String |
아니오 |
요청 헤더
Common Request Headers 외에도 다음 헤더를 사용할 수 있습니다.
| 파라미터 | 설명 | 필수 여부 |
|---|---|---|
| If-Match | 객체의 ETag가 요청에서 지정된 ETag와 동일하면 객체의 내용을 반환하고, 그렇지 않으면 412(Precondition Failed)를 반환합니다. 타입: string (예: 0f64741bf7cb1089e988e4585d0d3434) |
아니오 |
| If-Modified-Since | 객체의 수정 시간이 지정된 값 이후면 객체 내용을 반환하고, 그렇지 않으면 304(Not Modified)를 반환합니다. 타입: string |
아니오 |
| If-Unmodified-Since | 객체의 수정 시간이 지정된 값 이전이면 객체 내용을 반환하고, 아니면 412(Precondition Failed)를 반환합니다. 타입: string |
아니오 |
| If-None-Match | 객체의 ETag가 요청에서 지정한 값과 일치하지 않을 때 객체 내용을 반환하고, 일치하면 304(Not Modified)를 반환합니다. 타입: string |
아니오 |
| Range | 객체의 일부 범위만 조회합니다. 잘못된 범위일 경우 416(Requested Range Not Satisfiable)가 반환됩니다. 형식: bytes=0-4 또는 bytes=512-1024 등 |
아니오 |
요청 본문
없음
응답 문법
HTTP/1.1 status_code
x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time
<Object Content>
응답 헤더
Common Response Headers 외에도 아래의 헤더가 함께 제공됩니다.
| 이름 | 설명 |
|---|---|
| Etag | 업로드된 데이터의 Entity tag입니다. |
| x-wos-storage-class | 파일의 스토리지 클래스를 지정합니다. 지원값에는 Standard(표준), IA(저빈도), Archive(아카이브) 등이 있으며, 기본값은 버킷의 스토리지 클래스입니다. |
| x-amz-meta-* | 사용자 정의 메타데이터 |
참고: htm, html, jsp, plg, htx, stm 등의 정적 파일에 접근할 때, 응답에는
Content-Disposition: attachment헤더가 추가되어 브라우저 다운로드가 유도됩니다. 만약 브라우저 미리보기를 원한다면, 버킷 관리에서 커스텀 도메인을 바인딩해 해당 도메인으로 접근하면Content-Disposition: attachment헤더가 추가되지 않습니다.
응답 본문
없음
예시
GET /test HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/1
Host: bucket.s3-cn-east-1.wcsapi.com
Accept: */*
Date: Sat, 03 Dec 2011 08:28:02 +0000
Authorization: AWS BF6C09F302931425E9A7:tQ+A280jUgPCAdSTuUis35T9gWI=
HTTP/1.1 200 OK
x-wos-request-id: 001B21A61C6C0000013403098535528C
x-wos-storage-class: Standard
ETag: "507e3fff69b69bf57d303e807448560b"
Last-Modified: Sat, 03 Dec 2011 08:25:46 GMT
Accept-Ranges: bytes
Content-Length: 30
Content-Type: binary/octet-stream
Date: Sat, 03 Dec 2011 08:28:02 GMT
[30 bytes of object data]
이 문서의 내용이 도움이 되었습니까?
예
아니오