HeadContainer

Prev Next

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 가장 최근 복제본의 정보로 응답할지 여부를 설정
  • true | false
    • true: 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
  • 헤더가 생략된 경우, 응답이 가장 빠른 정보로 응답

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
project_id String Required 프로젝트 ID
container String Required 조회할 컨테이너(버킷) 이름

요청 예시

요청 예시는 다음과 같습니다.

curl -X HEAD "https://kr.archive.gov-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-Trans-Id와 동일
X-Container-Meta-name String - 해당 컨테이너(버킷)의 메타데이터
  • 헤더명의 name 부분이 메타데이터의 키 역할을 함
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