---
title: "HeadContainer"
slug: "storage-archivestorage-headcontainer"
updated: 2026-09-17T09:58:32Z
published: 2026-09-17T09:58:32Z
canonical: "api.ncloud-docs.com/storage-archivestorage-headcontainer"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.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/ja/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/ja/storage-archivestorage#%EC%9D%B8%EC%A6%9D)を参照 |
| `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-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のための2番目の 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
```