---
title: "Archive Storageの概要"
slug: "guide-archivestorage"
updated: 2026-10-08T09:45:35Z
published: 2026-10-08T09:45:35Z
canonical: "cli.ncloud-docs.com/guide-archivestorage"
---

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

# Archive Storageの概要

Classic/VPC環境で利用できます。

Archive Storageは大量データを低コストで長期間保管できる NAVERクラウドプラットフォームのサービスです。Archive Storageでは、コンテナ(バケット)およびオブジェクト管理機能に関する CLIを、OpenStack Swift CLIと互換性のある`swift`コマンドとして提供しています。

## Archive Storageの共通設定

Archive Storage CLIを使用するためのインストールおよび認証方法、共通して使用されるコマンドとオプション形式について説明します。

### インストール

Archive Storage CLIは、OpenStack Swiftクライアントをインストールして使用します。Pythonのバージョンに応じて、次のコマンドでインストールしてください。

Python 3.9以前のインストールコマンドは次の通りです。

```
pip install python-keystoneclient==3.17.0
pip install python-swiftclient==3.6.0
```

Python 3.10以降のインストールコマンドは次の通りです。

```
pip install python-keystoneclient==5.1.0
pip install python-swiftclient==4.3.0
```

              参考

              

OpenStack Swift CLIの詳細は、[OpenStack Swift CLIドキュメント](https://docs.openstack.org/ocata/cli-reference/swift.html)をご参照ください。

### 認証

Archive Storageは、認証情報を使ってトークンを発行し、サービスを利用します。認証コマンドは次の通りです。

```
swift --os-auth-url https://kr.archive.ncloudstorage.com:5000/v3 --auth-version 3 \
      --os-username {access_key_id} --os-password {secret_key} \
      --os-user-domain-id {domain_id} --os-project-id {project_id} \
      auth
```

              参考

              

- `access_key_id`と`secret_key`を確認する方法については、[APIの認証キー](https://api.ncloud-docs.com/docs/ja/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)をご参照ください。
- `project_id`と`domain_id`は、NAVERクラウドプラットフォームコンソールで Archive Storageサービスをお申し込みの後、**Container Management**メニューの **[API利用情報を確認]** ボタンをクリックしてご確認ください。

認証が成功すると、ストレージ URLと認証トークンが返されます。

```
export OS_STORAGE_URL=https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}
export OS_AUTH_TOKEN={token}
```

返された`export`コマンドを実行し、`OS_STORAGE_URL`と`OS_AUTH_TOKEN`を環境変数として宣言すると、再認証せずにサービスをリクエストできます。

```
export OS_STORAGE_URL=https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}
export OS_AUTH_TOKEN={token}

swift list
```

環境変数として宣言せずに、`--os-storage-url`や`--os-auth-token`オプションに値を直接入力することもできます。

```
swift --os-storage-url https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id} \
      --os-auth-token {token} \
      list
```

              参考

              

サービス認証 URLやトークン値を環境変数として保存せずに、認証コマンドを使用して認証情報をリクエストするたびに認証情報を併せて入力する方式は、その都度認証を行うことになるため、推奨しません。

### 構文

`swift`の構文は次の通りです。

```
swift <subcommand> [options]
```

### オプション

`swift`で共通して使用できるオプションです。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--os-storage-url` | String | Conditional | サービス URL - `--os-auth-token`と併せて入力 - 認証情報を直接入力する場合、未入力 |
| `--os-auth-token` | String | Conditional | 発行された認証トークン - `--os-storage-url`と併せて入力 - 認証情報を直接入力する場合、未入力 |
| `--os-auth-url` | String | Conditional | 認証 URL - `--os-storage-url`、`--os-auth-token`を入力しない場合、必ず入力 - 韓国リージョン: `https://kr.archive.ncloudstorage.com:5000/v3` |
| `--auth-version` | String | Conditional | 認証 APIバージョン - `--os-auth-url`入力時、必ず入力 - `3` |
| `--os-username` | String | Conditional | API認証キーの Access Key ID - `--os-auth-url`入力時、必ず入力 - [Ncloud API](https://api.ncloud-docs.com/docs/ja/common-ncpapi)を参照 |
| `--os-password` | String | Conditional | API認証キーの Secret Key - `--os-auth-url`入力時、必ず入力 - [Ncloud API](https://api.ncloud-docs.com/docs/ja/common-ncpapi)を参照 |
| `--os-user-domain-id` | String | Conditional | ユーザーが所属するドメイン ID - `--os-auth-url`入力時、必ず入力 - コンソールで **Archive Storage** > **Container Management**メニューの **[API利用情報を確認]** ボタンをクリックして確認 |
| `--os-project-id` | String | Conditional | ユーザーが所属するプロジェクト ID - `--os-auth-url`入力時、必ず入力 - コンソールで **Archive Storage** > **Container Management**メニューの **[API利用情報を確認]** ボタンをクリックして確認 |

## Archive Storageコマンド

`swift`配下で使用できるサブコマンドの一覧です。

| コマンド | 説明 |
| --- | --- |
| [auth](/docs/ja/cli-archivestorage-auth) | 認証環境変数を出力 |
| [post](/docs/ja/cli-archivestorage-post) | コンテナ(バケット)の作成およびメタデータの変更 |
| [upload](/docs/ja/cli-archivestorage-upload) | ファイルまたはディレクトリのアップロード |
| [list](/docs/ja/cli-archivestorage-list) | コンテナ(バケット)リストまたはオブジェクトリストを照会 |
| [stat](/docs/ja/cli-archivestorage-stat) | アカウント、コンテナ(バケット)、オブジェクト情報を照会 |
| [download](/docs/ja/cli-archivestorage-download) | オブジェクトをダウンロード |
| [copy](/docs/ja/cli-archivestorage-copy) | オブジェクトをコピー |
| [tempurl](/docs/ja/cli-archivestorage-tempurl) | オブジェクトアクセス用一時 URLを作成 |
| [delete](/docs/ja/cli-archivestorage-delete) | コンテナ(バケット)またはオブジェクトを削除 |
| [capabilities](/docs/ja/cli-archivestorage-capabilities) | クラスタサポート機能および制限値の照会 |

## Archive Storage関連リソース

Archive Storage CLIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- Archive Storage CLIサービスの使用方法
  - [Archive Storageご利用ガイド](https://guide.ncloud-docs.com/docs/ja/archivestorage-overview): NAVERクラウドプラットフォームコンソールで Archive Storageを使用する方法
  - [Archive Storage APIガイド](https://api.ncloud-docs.com/docs/ja/storage-archivestorage): Archive Storage APIを呼び出す方法
  - [Archive Storage利用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートに関する利用ガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/storage/archiveStorage): Archive Storageの料金体系、特徴、詳細機能のサマリー
  - [サービスの最新情報](https://www.ncloud.com/intro/news?categoryCode=STRG&amp;serviceCode=SV_0100): Archive Storageに関する最新情報
  - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=STRG&amp;categoryCode3=SV_0100): Archive Storageユーザーからよく寄せられる質問とその回答
  - [サポート](https://www.ncloud.com/v2/support/question/service): CLIガイドでは解決できない場合のお問い合わせ窓口