---
title: "HeadContainer "
slug: "storage-archivestorage-headcontainer"
tags: ["Archive Storage"]
updated: 2026-10-22T10:47:58Z
published: 2026-10-22T10:47:58Z
canonical: "api-gov.ncloud-docs.com/storage-archivestorage-headcontainer"
---

> ## 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.

# HeadContainer

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

컨테이너(버킷)의 메타데이터를 조회합니다.

          참고

          

Subaccount의 경우, Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다. 자세한 내용은 SubAccount의 [HeadContainer API](/docs/storage-archivestorage-headobject-subaccount)를 참조해 주십시오.

## 요청

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

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