HeadAccount

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

어카운트의 메타데이터를 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
HEAD /v1/AUTH_{project_id}

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
X-Auth-Token String Required 발급한 토큰(Token) 값
X-Newest Boolean Optional 가장 최근 복제본의 정보로 응답할지 여부를 설정
  • true | false
    • true: 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
  • 헤더가 생략된 경우, 응답이 가장 빠른 정보로 응답

요청 경로 파라미터

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

필드 타입 필수 여부 설명
project_id String Required 프로젝트 ID

요청 예시

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

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

응답

응답 형식을 설명합니다.

응답 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
Content-Type String - 응답 결과의 MIME 타입
Content-Length String - 응답 결과의 길이(Byte)
X-Account-Container-Count Integer - 해당 어카운트에 있는 전체 컨테이너(버킷) 개수
X-Account-Object-Count Integer - 해당 어카운트의 전체 오브젝트 개수
X-Account-Bytes-Used Integer - 해당 어카운트가 사용하는 전체 용량 크기(Byte)
X-Timestamp Integer - 어카운트가 생성된 시각(Unix Timestamp)
X-Account-Storage-Policy-name-Container-Count Integer - 헤더명의 name에 해당하는 storage policy의 전체 컨테이너(버킷) 개수
X-Account-Storage-Policy-name-Object-Count Integer - 헤더명의 name에 해당하는 storage policy의 전체 오브젝트 개수
X-Account-Storage-Policy-name-Bytes-Used Integer - 헤더명의 name에 해당하는 storage policy의 전체 용량 크기(Bytes)
X-Account-Meta-name String Optional 어카운트의 메타데이터
  • 헤더명의 name 부분이 메타데이터의 키 역할을 함
X-Account-Meta-Temp-URL-Key String Optional temporary URL을 위한 Secret Key 값
X-Account-Meta-Temp-URL-Key-2 String Optional temporary URL을 위한 두 번째 Secret Key 값
Accept-Ranges String - 해당 어카운트가 허용하는 Range 타입
x-account-project-domain-id String - API 이용 시 필요한 Domain ID
X-Trans-Id String - 해당 요청의 트랜잭션 ID
X-Openstack-Request-Id String - 해당 요청의 트랜잭션 ID
  • X-Trans-Id와 동일
X-Account-Meta-Quota-Bytes String Optional 해당 어카운트의 용량 제한값(Byte)
Date String - 해당 요청의 응답 시간(UTC)

응답 예시

응답 예시는 다음과 같습니다.

HTTP/1.1 204 No Content
Content-Length: 0
Accept-Ranges: bytes
X-Account-Meta-Book: ncloud-test-book
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 420024
X-Account-Container-Count: 2
Content-Type: text/plain; charset=utf-8
X-Account-Object-Count: 2
x-account-project-domain-id: default
X-Trans-Id: tx9001d378488c4e5dbc64a-005b975d96
X-Openstack-Request-Id: tx9001d378488c4e5dbc64a-005b975d96
Date: Tue, 11 Sep 2018 06:15:50 GMT