--- title: "Object Storageの概要" slug: "guide-objectstorage" updated: 2026-10-08T09:50:13Z published: 2026-10-08T09:50:13Z canonical: "cli.ncloud-docs.com/guide-objectstorage" --- > ## 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. # Object Storageの概要 Classic/VPC環境で利用できます。 Object Storageは、インターネット上にデータを保存・管理できる NAVERクラウドプラットフォームのサービスです。Object Storageでは、バケットおよびオブジェクト管理機能に関する CLIを、Amazon S3 CLIと互換性のある`aws`コマンドとして提供しています。 ## Object Storageの共通設定 Object Storage CLIを使用するためのインストールおよび認証方法、共通して使用されるコマンドとオプション形式について説明します。 ### インストール Object Storage CLIは AWS CLIをインストールして使用します。インストールコマンドは次の通りです。 ``` pip install awscli==1.15.85 ``` 参考 - awscli 1.16.x以降のバージョンでは一部機能がサポートされないため、1.15.x系のご利用を推奨します。 - awscli 1.15.85バージョンは Python 3.8以前のバージョンで動作します。 - 関連資料については、次をご参照ください。 - ドキュメント: [awscli 1.15.85](https://pypi.org/project/awscli/1.15.85/) - git: [aws-cli 1.15.85](https://github.com/aws/aws-cli/tree/1.15.85/) ### 認証 認証情報を設定するコマンドは次の通りです。 ``` aws configure ``` コマンドを実行すると、次の項目を順に入力します。 ``` AWS Access Key ID [****************leLy]: {access_key_id} AWS Secret Access Key [None]: {secret_key} Default region name [None]: [Enter] Default output format [None]: [Enter] ``` 参考 - `access_key_id`と`secret_key`は[NcloudAPI](https://api.ncloud-docs.com/docs/ja/common-ncpapi)を参照して作成した API認証キーを使用します。 - Roleを付与されたサーバは、別途認証設定を行うことなく Object Storageコマンドを使用できます。この場合、Metadata APIの認証キー照会 APIを使用するためタイムアウトが発生する可能性があり、次のコマンドでタイムアウトを延長できます。 ``` export AWS_METADATA_SERVICE_TIMEOUT=10 ``` ### 構文 `aws`の構文は次の通りです。 ``` aws s3 [options] --endpoint-url aws s3api [options] --endpoint-url ``` `s3`はファイル単位の操作に最適化された high-levelコマンドで、`s3api`は Object Storage APIと1:1で対応する API-levelコマンドです。 ヘルプを確認するコマンドは次の通りです。 ``` aws help aws help aws help ``` ### オプション `aws`で共通して使用できるオプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--endpoint-url` | String | Required | コマンドを呼び出すエンドポイント URL - リージョンごとの呼び出しドメインは[Object Storage APIガイド](https://api.ncloud-docs.com/docs/ja/storage-objectstorage#%ED%98%B8%EC%B6%9C%EB%8F%84%EB%A9%94%EC%9D%B8Endpoint)を参照 | | `--region` | String | Optional | リージョン - 韓国リージョンのみ対応 | | `--profile` | String | Optional | 認証情報ファイルおよび設定ファイルで使用するプロファイル名 - デフォルト: `default` - 認証情報以外にも、リージョンや出力形式などプロファイルに保存された設定も併せて適用 | | `--no-sign-request` | 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 | 自動ページネーションを無効化 - 結果の最初のページのみ照会 | | `--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 | デバッグロギングを有効化 | ## Object Storageのコマンド `aws`配下で使用できるサブコマンドの一覧です。 ### High-level ファイル単位の操作に使用する`s3`関連コマンドは次の通りです。 | コマンド | 説明 | | --- | --- | | [mb](/docs/ja/cli-objectstorage-high-level-mb) | バケットを作成 | | [ls](/docs/ja/cli-objectstorage-high-level-ls) | バケット、フォルダ、オブジェクトリストを照会 | | [cp](/docs/ja/cli-objectstorage-high-level-cp) | オブジェクトのアップロード、ダウンロードおよびコピー | | [sync](/docs/ja/cli-objectstorage-high-level-sync) | ディレクトリとバケット間の同期 | | [rm](/docs/ja/cli-objectstorage-high-level-rm) | オブジェクトを削除 | | [rb](/docs/ja/cli-objectstorage-high-level-rb) | バケットを削除 | ### API-level Object Storage APIと1:1で対応する`s3api`関連コマンドは次の通りです。 | コマンド | 説明 | | --- | --- | | [create-bucket](/docs/ja/cli-objectstorage-api-level-create-bucket) | バケットを作成 | | [list-buckets](/docs/ja/cli-objectstorage-api-level-list-buckets) | バケットリストを照会 | | [delete-bucket](/docs/ja/cli-objectstorage-api-level-delete-bucket) | バケットを削除 | | [get-bucket-cors](/docs/ja/cli-objectstorage-api-level-get-bucket-cors) | バケット CORSルールを照会 | | [put-bucket-cors](/docs/ja/cli-objectstorage-api-level-put-bucket-cors) | バケット CORSルールを設定 | | [put-object](/docs/ja/cli-objectstorage-api-level-put-object) | オブジェクトをアップロード | | [get-object](/docs/ja/cli-objectstorage-api-level-get-object) | オブジェクトをダウンロード | | [list-objects](/docs/ja/cli-objectstorage-api-level-list-objects) | オブジェクトリストを照会 | | [put-object-acl](/docs/ja/cli-objectstorage-api-level-put-object-acl) | オブジェクトアクセス制御リストを設定 | | [delete-object](/docs/ja/cli-objectstorage-api-level-delete-object) | オブジェクトを削除 | | [create-multipart-upload](/docs/ja/cli-objectstorage-api-level-create-multipart-upload) | マルチパートアップロードを開始 | | [upload-part](/docs/ja/cli-objectstorage-api-level-upload-part) | マルチパートアップロードのパートをアップロード | | [complete-multipart-upload](/docs/ja/cli-objectstorage-api-level-complete-multipart-upload) | マルチパートアップロード完了 | | [list-multipart-uploads](/docs/ja/cli-objectstorage-api-level-list-multipart-uploads) | 進行中のマルチパートアップロードリストを照会 | | [abort-multipart-upload](/docs/ja/cli-objectstorage-api-level-abort-multipart-upload) | マルチパートアップロードを停止 | ## Object Storage関連リソース Object Storage CLIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。 - Object Storage CLIサービスの使用方法 - [Object Storageご利用ガイド](https://guide.ncloud-docs.com/docs/ja/storage-storage-6-1): NAVERクラウドプラットフォームコンソールで Object Storageを使用する方法 - [Object Storage APIガイド](https://api.ncloud-docs.com/docs/ja/storage-objectstorage): Object Storage APIを呼び出す方法 - [Object Storage利用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートに関する利用ガイド - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/storage/objectStorage): Object Storageの料金体系、特徴、詳細機能のサマリー - [サービスの最新情報](https://www.ncloud.com/intro/news?categoryCode=STRG&serviceCode=SV_0011): Object Storageに関する最新情報 - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=STRG&categoryCode3=SV_0011): Object Storageユーザーからよく寄せられる質問とその回答 - [サポート](https://www.ncloud.com/v2/support/question/service): CLIガイドでは解決できない場合のお問い合わせ窓口