HeadObject

개요

오브젝트의 메타데이터를 조회합니다.

구문

HEAD /v1/AUTH_{project_id}/{container}/{object}

요청

Name In Type Description
project_id path string 프로젝트 ID를 입력합니다.
container path string 컨테이너(버킷) 이름을 입력합니다.
object path string 오브젝트의 이름을 입력합니다.
X-Auth-Token (Optional) header string 발급한 Token 값을 입력합니다.
temp_url_sig query string temp url
temp_url_expires query integer temp url
filename (Optional) query string tem url
multipart-manifest (Optional) query string multipart-manifest=get 이고, 해당 오브젝트가 대용량 오브젝인인 경우, 오브젝트의 메타데이터 대신 매니페스트 메타데이터와 dynamic 대용량 메타데이터의 X-Object-Manifest 헤더가응답합니다.
X-Newest (Optional) header boolean true인 경우, 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답합니다. 해당 헤더가 생략된 경우, 가장 응답이 빠른 정보로 응답합니다.
If-Match (Optional) header string ETag 조건 헤더입니다. 자세한 정보는 해당 링크에서 확인 : RFC2616
If-None-Match (Optional) header string ETag 조건 헤더입니다. 자세한 정보는 해당 링크에서 확인 : RFC2616
If-Modified-Since (Optional) header string Last-Modified 조건 헤더입니다. 자세한 정보는 해당 링크에서 확인 : RFC2616
If-Unmodified-Since (Optional) header string Last-Modified 조건 헤더입니다. 자세한 정보는 해당 링크에서 확인 : RFC2616

응답

Name In Type Description
Content-Length header string 응답 결과의 길이입니다. (Bytes)
X-Object-Meta-name (Optional) header string 해당 오브젝트의 메타데이터입니다. 헤더명의 name 부분이 메타데이터의 키 역할을 합니다.
Content-Disposition (Optional) header string 브라우저에 대한 작동을 재정의 합니다.
Content-Encoding (Optional) header string 해당 오브젝트의 인코딩 방식입니다.
X-Delete-At (Optional) header integer 해당 오브젝트의 삭제 예정 시간입니다. (UNIX Time)
X-Object-Manifest (Optional) header string 해당 오브젝트가 대용량 오브젝트(DLO)인 경우 응답됩니다. 세그먼트 오브젝트의 경로가 나타납니다.
Last-Modified header string 해당 오브젝트가 수정된 가장 최근 시간입니다. (UTC)
ETag header string ETag 헤더 값입니다.
X-Timestamp header string 해당 요청의 응답 시간입니다. (Unix Epoch timestamp)
X-Trans-Id header string 해당 요청의 트랜젝션 ID입니다.
X-Openstack-Request-Id header string 해당 요청의 트랜젝션 ID입니다. (X-Trans-Id와 동일합니다.)
Date header string 해당 요청의 응답 시간입니다. (UTC)
X-Static-Large-Object header boolean true인 경우, 해당 오브젝트는 대용량 오브젝트(SLO)의 매니페스트 오브젝트입니다.
Content-Type header string 응답 결과의 MIME 타입입니다.

예시

요청 예시

curl -i -X HEAD -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}

응답 예시

HTTP/1.1 200 OK
Content-Length: 10485760
Accept-Ranges: bytes
Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
Etag: f1c9645dbc14efddc7d8a322685f26eb
X-Timestamp: 1537170219.48936
Content-Type: application/x-www-form-urlencoded
X-Trans-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
X-Openstack-Request-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
Date: Mon, 17 Sep 2018 08:49:21 GMT

오브젝트 메타데이터를 조회합니다. 요청이 성공하게 되면 OK (200) 상태 코드를 응답합니다.