개요
오브젝트의 메타데이터를 조회합니다.
구문
HEAD /v1/AUTH_{project_id}/{container}/{object}
요청
| 명칭 | In | 타입 | 설명 |
|---|---|---|---|
| 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) |
응답
| 명칭 | In | 타입 | 설명 |
|---|---|---|---|
| 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.gov-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) 상태 코드를 응답합니다.