--- title: "Ncloud Storageの概要" slug: "storage-ncloudstorage" updated: 2026-10-08T09:46:22Z published: 2026-10-08T09:46:22Z canonical: "cli.ncloud-docs.com/storage-ncloudstorage" --- > ## 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. # Ncloud Storageの概要 Classic/VPC環境で利用できます。 Ncloud Storageは、インターネット上でデータを保存および管理できる、NAVERクラウドプラットフォームのオブジェクトストレージサービスです。Ncloud Storageでは、バケットおよびオブジェクト管理機能に関する CLIを、Amazon S3 CLIと互換性のある`aws`コマンドとして提供しています。 ## Ncloud Storageの共通設定 Ncloud Storage CLIの使用に必要なインストールと認証の方法、および共通して使用されるコマンドやオプションの形式について説明します。 ### インストール Ncloud Storage CLIは、AWS CLIをインストールして使用します。インストールコマンドは次の通りです。 ``` pip3 install awscli ``` 参考 `pip3`コマンドでは AWS CLI v1がインストールされます。このガイドの例は v1の出力を基準に作成されています。AWS CLI v2のインストール方法は、[AWS CLIインストールガイド](https://docs.aws.amazon.com/ko_kr/cli/latest/userguide/getting-started-install.html)をご参照ください。 ### 認証 認証情報を設定するコマンドは次の通りです。 ``` aws configure ``` コマンドを実行した後、次の項目を順に入力してください。 ``` AWS Access Key ID [None]: {access_key_id} AWS Secret Access Key [None]: {secret_key} Default region name [None]: kr Default output format [None]: [Enter] ``` 参考 - `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)をご参照ください。 - Ncloud Storageは、現在 KRリージョンのみサポートしています。 - 対応している出力形式は`json`、`text`、`table`、`yaml`、`yaml-stream`です。 ### 構文 `aws`の構文は次の通りです。 ``` aws s3 [options] --endpoint-url aws s3api [options] --endpoint-url ``` 参考 - CLIを利用する際は、必ず`--endpoint-url`オプションを入力してください。リージョンごとの呼び出しドメインは次の通りです。 - リージョン: 韓国 - リージョン名: kr - 呼び出しドメイン: https://kr.ncloudstorage.com - 提供リージョンは今後も継続的に拡大していく予定です。 `s3`は Ncloud Storageをファイルシステムのように扱う High-levelコマンドであり、`s3api`は Ncloud Storage APIと1:1で対応する API-levelのコマンドです。 ヘルプを確認するコマンドは次の通りです。 ``` aws help aws help aws help ``` ### オプション `aws`で共通して使用できるオプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--endpoint-url` | String | Required | コマンドを呼び出すエンドポイント URL - `https://kr.ncloudstorage.com` - KRリージョンのみ対応 | | `--region` | String | Optional | リージョン - `kr` | | `--profile` | String | Optional | 認証情報ファイルおよび設定ファイルで使用するプロファイル名 - デフォルト: `default` - 認証情報以外にも、リージョンや出力形式などプロファイルに保存された設定も併せて適用 | | `--no-sign-request` | Boolean | Optional | リクエスト署名を無効化 - 認証情報を読み込まず匿名でリクエスト | | `--cli-input-json`, `--cli-input-yaml` | String | Optional | JSONまたは YAML形式でコマンドのパラメータを入力 - `file://`接頭辞を使用してローカルファイルパスを指定 - JSONと YAMLを同時に指定不可 - API-levelのコマンドのみ対応 | | `--generate-cli-skeleton` | String | Optional | コマンドを実行せずにパラメータテンプレートを作成 - `input` (デフォルト) \| `yaml-input` \| `output` - API-levelのコマンドのみ対応 | | `--cli-auto-prompt` | Boolean | Optional | オプション自動プロンプトを有効化 - コマンドとオプションを会話形式で選択して入力 | | `--no-cli-auto-prompt` | Boolean | Optional | オプション自動プロンプトを無効化 | | `--output` | String | Optional | レスポンス結果の形式 - `json` (デフォルト) \| `text` \| `table` \| `yaml` \| `yaml-stream` | | `--query` | String | Optional | レスポンス結果の絞り込みに使用する JMESPathクエリ | | `--color` | String | Optional | 出力色を使用するか - `on` \| `off` \| `auto` (デフォルト) | | `--no-paginate` | Boolean | Optional | 自動ページネーションを無効化 - 結果の最初のページのみ照会 | | `--no-cli-pager` | Boolean | Optional | CLIページャーを無効化 - ページャーを経由せず標準出力で結果を返す | | `--ca-bundle` | String | Optional | SSL証明書を検証する際に使用する CA証明書バンドルのパス | | `--no-verify-ssl` | Boolean | Optional | SSL証明書検証を無効化 | | `--cli-connect-timeout` | Integer | Optional | 最大接続時間 (秒) - デフォルト: `60` - `0`を入力するとタイムアウトなしでグロック状態で動作 | | `--cli-read-timeout` | Integer | Optional | 最大読み取り時間 (秒) - デフォルト: `60` - `0`を入力するとタイムアウトなしでブロック状態で動作 | | `--debug` | Boolean | Optional | デバッグロギングを有効化 | ## Ncloud Storageのコマンド `aws`配下で使用できるサブコマンドの一覧です。 ### High-level High-levelコマンドを使用すると、Ncloud Storageをファイルシステムのようにアクセスしたり管理することができます。関連するコマンドは次の通りです。 | コマンド | 説明 | | --- | --- | | [mb](/docs/ja/mb) | バケットを作成 | | [ls](/docs/ja/ls) | バケットとオブジェクトを照会 | | [cp](/docs/ja/cp) | オブジェクトをコピー | | [mv](/docs/ja/mv) | バケットを移動 | | [sync](/docs/ja/sync) | オブジェクトを同期 | | [presign](/docs/ja/presign) | オブジェクトの事前署名付き(Pre-signed) URLを作成 | | [rm](/docs/ja/rm) | オブジェクトを削除 | | [rb](/docs/ja/rb) | バケットを削除 | ### API-level API-levelのコマンドは、Ncloud Storage APIと1:1で対応しています。関連するコマンドは次の通りです。 | コマンド | 説明 | | --- | --- | | [create-bucket](/docs/ja/create-bucket) | Ncloud Storageにオブジェクト保存先のバケットを作成 | | [list-buckets](/docs/ja/list-buckets) | ユーザーが所有するすべてのバケットリストを照会 | | [head-bucket](/docs/ja/head-bucket) | Ncloud Storageに作成したバケットの属性を照会 | | [get-bucket-location](/docs/ja/get-bucket-location) | Ncloud Storageに作成したバケットのリージョン情報を照会 | | [delete-bucket](/docs/ja/delete-bucket) | Ncloud Storageに作成したバケットを削除 | | [get-bucket-versioning](/docs/ja/get-bucket-versioning) | バケットのバージョン管理設定の有無を照会 | | [put-bucket-versioning](/docs/ja/put-bucket-versioning) | バケットのバージョン管理を設定 | | [get-bucket-encryption](/docs/ja/get-bucket-encryption) | バケットに設定された暗号化方式を照会 | | [put-bucket-encryption](/docs/ja/put-bucket-encryption) | バケットにデフォルトのサーバ側暗号化(SSE)を設定 | | [delete-bucket-encryption](/docs/ja/delete-bucket-encryption) | バケットに設定された暗号化設定を削除 | | [get-bucket-cors](/docs/ja/get-bucket-cors) | バケットに設定された CORSルールを照会 | | [put-bucket-cors](/docs/ja/put-bucket-cors) | バケットに CORSルールを設定 | | [delete-bucket-cors](/docs/ja/delete-bucket-cors) | バケットに設定された CORSルールを削除 | | [get-bucket-lifecycle-configuration](/docs/ja/get-bucket-lifecycle-configuration) | バケットに登録されたライフサイクルルールを照会 | | [put-bucket-lifecycle-configuration](/docs/ja/put-bucket-lifecycle-configuration) | バケットにライフサイクルルールを登録 | | [delete-bucket-lifecycle](/docs/ja/delete-bucket-lifecycle) | バケットに登録されたライフサイクルルールを削除 | | [get-object-lock-configuration](/docs/ja/get-object-lock-configuration) | バケットに設定された Object Lock設定を照会 | | [put-object-lock-configuration](/docs/ja/put-object-lock-configuration) | バケットに Object Lock設定を適用 | | [put-object](/docs/ja/put-object) | Ncloud Storageにオブジェクトを保存 | | [get-object](/docs/ja/get-object) | Ncloud Storageに作成したオブジェクトをダウンロード | | [head-object](/docs/ja/head-object) | Ncloud Storageに保存したオブジェクトのメタデータを照会 | | [copy-object](/docs/ja/copy-object) | Ncloud Storageに保存したオブジェクトをコピー | | [get-object-attributes](/docs/ja/get-object-attributes) | Ncloud Storageに保存されたオブジェクトの属性を照会 | | [list-objects](/docs/ja/list-objects) | バケットに保存されたオブジェクトリストを照会 | | [list-objects-v2](/docs/ja/list-objects-v2) | バケットに保存されたオブジェクトリストを照会 | | [list-object-versions](/docs/ja/list-object-versions) | バージョン管理を使用しているバケットに保存されたオブジェクトのすべてのバージョンのメタデータを照会 | | [delete-object](/docs/ja/delete-object) | Ncloud Storageに保存したオブジェクトを削除 | | [delete-objects](/docs/ja/delete-objects) | Ncloud Storageに保存した複数のオブジェクトを同時に削除 | | [restore-object](/docs/ja/restore-object) | Deep Archive Classに保存したオブジェクトを復元 | | [get-object-legal-hold](/docs/ja/get-object-legal-hold) | オブジェクトに設定されたリーガルホールド(Legal Hold)状態を照会 | | [put-object-legal-hold](/docs/ja/put-object-legal-hold) | オブジェクトにリーガルホールド(Legal Hold)を設定 | | [get-object-retention](/docs/ja/get-object-retention) | オブジェクトに設定されたリテンション(Retention)情報を照会 | | [put-object-retention](/docs/ja/put-object-retention) | オブジェクトにリテンション(Retention)を設定 | | [create-multipart-upload](/docs/ja/create-multipart-upload) | マルチパートアップロードを開始し、アップロード IDを返す | | [upload-part](/docs/ja/upload-part) | マルチパートアップロードのパートをアップロード | | [upload-part-copy](/docs/ja/upload-part-copy) | Ncloud Storageに保存されている大容量オブジェクトをコピー | | [list-parts](/docs/ja/list-parts) | 特定のマルチパートアップロードを通じてアップロードされたパートリストを照会 | | [list-multipart-uploads](/docs/ja/list-multipart-uploads) | 現在実行中のマルチパートアップロードリストを照会 | | [complete-multipart-upload](/docs/ja/complete-multipart-upload) | アップロードしたパートを組み合わせてオブジェクトを作成し、マルチパートのアップロードを完了 | | [abort-multipart-upload](/docs/ja/abort-multipart-upload) | 実行中のマルチパートアップロードを中断 | ## Ncloud Storage関連リソース Ncloud Storage CLIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。 - Ncloud Storage CLIサービスの使用方法 - [Ncloud Storageご利用ガイド](https://guide.ncloud-docs.com/docs/ja/ncloudstorage-overview): NAVERクラウドプラットフォームコンソールで Ncloud Storageを使用する方法 - [Ncloud Storage APIガイド](https://api.ncloud-docs.com/docs/ja/storage-ncloudstorage): Ncloud Storage APIの呼び出し方法 - [Ncloud Storage利用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートの有無に関するご利用ガイド - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/storage/ncloudStorage): Ncloud Storageの料金体系、特長、詳細機能のサマリー - [サービスの最新情報](https://www.ncloud.com/intro/news?categoryCode=STRG&serviceCode=SV_0269): Ncloud Storageに関する最新情報 - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=STRG&categoryCode3=SV_0269): Ncloud Storageユーザーからよく寄せられる質問とその回答 - [サポート](https://www.ncloud.com/v2/support/question/service): CLIガイドでは解決できない場合のお問い合わせ窓口