---
title: "HeadAccount "
slug: "storage-archivestorage-headaccount"
updated: 2026-10-22T10:47:58Z
published: 2026-10-22T10:47:58Z
canonical: "api-gov.ncloud-docs.com/storage-archivestorage-headaccount"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HeadAccount

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 - 프로젝트 ID 확인 방법은 [Archive Storage 개요](/docs/storage-archivestorage#%EC%9D%B8%EC%A6%9D) 참조 |

### 요청 예시

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

```
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
```