HeadObject
최신 업데이트：2025-08-18 15:52:08
객체의 메타데이터를 조회하기 위해 HEAD 요청을 전송합니다. 이 방식은 파일의 내용은 반환하지 않습니다. IAM wos:HeadObject 권한이 필요합니다.
요청 문법
HEAD /ObjectName HTTP/1
Host: Bucket.Endpoint
Date: date
Authorization: authorization
URI 요청 파라미터
없음
요청 헤더
common request headers 외에도 다음을 포함합니다.
| 이름 | 설명 | 필수 여부 |
|---|---|---|
| If-Match | 요청 내 ETag와 버킷 내 객체의 ETag가 일치하면 해당 객체의 메타데이터를 반환하고, 그렇지 않으면 412(Precondition Failed)를 반환합니다. 타입: string (예: 0f64741bf7cb1089e988e4585d0d3434) |
아니오 |
| If-Modified-Since | 객체가 If-Modified-Since 시간 이전에 수정된 적이 있을 때만 메타데이터를 반환하며, 아니면 304(Not Modified)가 반환됩니다. 타입: string |
아니오 |
| If-Unmodified-Since | 객체가 If-Unmodified-Since 시간 이후에 한 번도 수정되지 않았다면 메타데이터를 반환하고, 아니면 412(Precondition Failed)가 반환됩니다. 타입: string |
아니오 |
| If-None-Match | 요청 내 ETag와 버킷 내 객체의 ETag가 일치하지 않으면 객체의 내용을 반환하고, 일치하면 304(Not Modified)가 반환됩니다. 타입: string (예: 0f64741bf7cb1089e988e4585d0d3434) |
아니오 |
| Range | 객체의 일부 범위의 콘텐츠를 조회합니다. 잘못된 값이면 416(Requested Range Not Satisfiable)이 반환됩니다. 범위는 시작 바이트가 0이고, 종료 바이트는 객체 길이 - 1 입니다. 타입: string (bytes=byte_range, 예: bytes=0-4 또는 bytes=512-1024) |
아니오 |
요청 본문
없음
응답 문법
HTTP/1.1 status_code
x-amz-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time
Server: WS-web-server
응답 헤더
common response headers 외에도 다음 헤더를 사용할 수 있습니다.
| 이름 | 설명 |
|---|---|
| Etag | 업로드된 객체의 엔터티 태그(Entity tag)입니다. |
| x-wos-storage-class | 객체의 스토리지 클래스를 지정합니다. 지원 값: Standard(표준 스토리지), IA(저빈도 접근 스토리지), Archive(아카이브 스토리지). 기본값은 버킷의 스토리지 클래스입니다. |
| x-amz-meta-* | 사용자 정의 메타데이터입니다. |
응답 본문
없음
특수 에러
| 상황 | HTTP 상태 코드 | 오류 코드 | 메시지 |
|---|---|---|---|
| Range 헤더가 제공됐으나, 범위 값이 잘못된 경우 | 416 Requested Range Not Satisfiable | InvalidRange | The requested range cannot be satisfied. |
예시
HEAD /objectName HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/1
Host: bucket.s3-cn-east-1.wcsapi.com
Accept: */*
Date: Sat, 03 Dec 2011 09:17:57 +0000
Authorization: WOS BF6C09F302931425E9A7:++6NkzwVhw4qccNfIqf4G2vMggg=
HTTP/1.1 200 OK
x-amz-request-id: 001B21A61C6C0000013403373811529D
ETag: "507e3fff69b69bf57d303e807448560b"
Last-Modified: Sat, 03 Dec 2011 08:47:50 GMT
Content-Length: 30
Content-Type: binary/octet-stream
Date: Sat, 03 Dec 2011 09:17:57 GMT
Server: WS-web-server
이 문서의 내용이 도움이 되었습니까?
예
아니오