HeadContainer
- 인쇄
- PDF
HeadContainer
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
개요
컨테이너(버킷)의 메타데이터를 조회합니다.
주의
Subaccount의 경우, Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다.
자세한 내용은 Subaccount를 참고해 주십시오.
구문
HEAD /v1/AUTH_{project_id}/{container}
요청
| Name | In | Type | Description |
|---|---|---|---|
| project_id | path | string | 프로젝트 ID 입력 |
| container | path | string | - 조회할 컨테이너(버킷) 이름 입력 - slash(/)가 포함되게 되면, {container}/{object}로 인식하므로 주의 |
| X-Auth-Token (Optional) | header | string | 발급한 Token 값 입력 |
| X-Newest (Optional) | header | boolean | - true인 경우 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답 - 해당 헤더가 생략된 경우 가장 응답이 빠른 정보로 응답 |
응답
| Name | In | Type | Description |
|---|---|---|---|
X-Container-Meta-name | header | string | - 해당 컨테이너(버킷)의 메타데이터 - 헤더명의 name 부분이 메타데이터의 키 역할을 함 |
| Content-Length | header | string | 응답 결과의 길이 (Bytes) |
| X-Container-Object-Count | header | integer | 해당 컨테이너(버킷)의 오브젝트 개수 |
| X-Container-Bytes-Used | header | integer | 해당 컨테이너(버킷)가 사용하는 전체 용량 크기 (Bytes) |
| X-Container-Read (Optional) | header | string | 해당 컨테이너의 READ ACL |
| X-Container-Write (Optional) | header | string | 해당 컨테이너의 WRITE ACL |
| X-Container-Meta-Quota-Bytes (Optional) | header | string | 해당 컨테이너(버킷)의 용량 제한값 (bytes) |
| X-Container-Meta-Quota-Count (Optional) | header | string | 해당 컨테이너(버킷)의 오브젝트 수의 제한값 |
| X-Container-Meta-Access-Control-Allow-Origin (Optional) | header | string | CORS |
| X-Container-Meta-Access-Control-Max-Age (Optional) | header | string | CORS |
| X-Container-Meta-Access-Control-Expose-Headers (Optional) | header | string | CORS |
| X-Container-Meta-Temp-URL-Key (Optional) | header | string | temporary URL을 위한 Secret Key 값 |
| X-Container-Meta-Temp-URL-Key-2 (Optional) | header | string | temporary URL을 위한 두 번째 Secret Key 값 |
| X-Timestamp | header | integer | 해당 컨테이너(버킷)가 생성된 시각 (UNIX Time) |
| X-Container-Sync-Key (Optional) | header | string | not supported |
| X-Container-Sync-To (Optional) | header | string | not supported |
| Date | header | string | 해당 요청의 응답 시간 (UTC) |
| X-Trans-Id | header | string | 해당 요청의 트랜젝션 ID |
| X-Openstack-Request-Id | header | string | 해당 요청의 트랜젝션 ID (X-Trans-Id와 동일) |
| Content-Type (Optional) | header | string | 응답 결과의 MIME 타입 |
| X-Versions-Location (Optional) | header | string | not supported |
| X-History-Location (Optional) | header | string | not supported |
예시
요청 예시(컨테이너 메타데이터 조회)
curl -i -X HEAD -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}
응답 예시
HTTP/1.1 204 No Content
Content-Length: 0
X-Container-Object-Count: 3
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 630036
Content-Type: text/plain; charset=utf-8
X-Trans-Id: tx51f8478e8e924403851a4-005b988014
X-Openstack-Request-Id: tx51f8478e8e924403851a4-005b988014
Date: Wed, 12 Sep 2018 02:55:16 GMT
요청이 성공하게 되면 No Content (204) 상태 코드를 응답합니다.
이 문서가 도움이 되었습니까?