HeadContainer
- 인쇄
- PDF
HeadContainer
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
컨테이너(버킷)의 메타데이터를 조회합니다.
참고
Subaccount의 경우, Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다.
자세한 내용은 SubAccount의 HeadContainer API를 참조해 주십시오.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| HEAD | /v1/AUTH_{project_id}/{container} |
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
X-Auth-Token | String | Required | 발급한 토큰(Token) 값 |
X-Newest | Boolean | Optional | 가장 최근 복제본의 정보로 응답할지 여부를 설정
|
요청 경로 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
project_id | String | Required | 프로젝트 ID
|
container | String | Required | 조회할 컨테이너(버킷) 이름 |
요청 예시
요청 예시는 다음과 같습니다.
curl -X HEAD "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}"
-H "X-Auth-Token: $token"
응답
응답 형식을 설명합니다.
응답 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
Content-Type | String | - | 응답 결과의 MIME 타입 |
Content-Length | String | - | 응답 결과의 길이 (Byte) |
X-Container-Object-Count | Integer | - | 해당 컨테이너(버킷)의 전체 오브젝트 개수 |
X-Container-Bytes-Used | Integer | - | 해당 컨테이너(버킷)가 사용하는 전체 용량 크기(Byte) |
X-Timestamp | Integer | - | 컨테이너(버킷)가 생성된 시각(UNIX timestamp) |
X-Container-Read | String | - | 해당 컨테이너(버킷)의 READ ACL(접근 권한) |
X-Container-Write | String | - | 해당 컨테이너(버킷)의 WRITE ACL(접근 권한) |
Last-Modified | String | - | 해당 컨테이너(버킷)의 가장 최근 수정 시간(UTC) |
Accept-Ranges | String | - | 해당 컨테이너(버킷)가 허용하는 범위 유형 |
X-Storage-Policy | String | - | 해당 컨테이너(버킷)의 Storage Policy 값 |
X-Trans-Id | String | - | 해당 요청의 트랜잭션 ID |
X-Openstack-Request-Id | String | - | 해당 요청의 트랜잭션 ID
|
X-Container-Meta-name | String | - | 해당 컨테이너(버킷)의 메타데이터
|
X-Container-Meta-Quota-Count | String | - | 해당 컨테이너(버킷)의 오브젝트 수의 제한값 |
X-Container-Meta-Quota-Bytes | String | - | 해당 컨테이너(버킷)의 용량 제한값 |
X-Container-Meta-Access-Control-Allow-Origin | String | - | CORS 설정
|
X-Container-Meta-Access-Control-Max-Age | String | - | CORS 설정
|
X-Container-Meta-Access-Control-Expose-Headers | String | - | CORS 설정
|
X-Container-Meta-Temp-URL-Key | String | - | Temporary URL을 위한 Secret Key 값 |
X-Container-Meta-Temp-URL-Key-2 | String | - | Temporary URL을 위한 두 번째 Secret Key 값 |
X-Container-Sync-Key | String | - | 사용하지 않음 |
X-Container-Sync-To | String | - | 사용하지 않음 |
X-Versions-Location | String | - | 사용하지 않음 |
X-History-Location | String | - | 사용하지 않음 |
Date | String | - | 해당 요청의 응답 시간(UTC) |
응답 예시
응답 예시는 다음과 같습니다.
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
이 문서가 도움이 되었습니까?