---
title: "Ncloud Storageの概要"
slug: "storage-ncloudstorage"
updated: 2026-09-17T09:58:30Z
published: 2026-09-17T09:58:30Z
canonical: "api.ncloud-docs.com/storage-ncloudstorage"
---

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

# Ncloud Storageの概要

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

Ncloud Storageは、優れた拡張性と可用性、データ耐久性を保証し、いつでもデータを保存したり検索したりできる NAVERクラウドプラットフォームのオブジェクトストレージサービスです。Ncloud Storageサービスは、バケットの管理、オブジェクトのアップロードなどデータを保存・管理する機能関連の APIを RESTful形式で提供します。

              参考

              

Ncloud Storage APIは、Amazon S3 API v2006-03-01と高いレベルの互換性を持つように設計されています。Ncloud Storage APIの詳細は、AWSの[S3 API Reference](https://docs.aws.amazon.com/AmazonS3/latest/API/Type_API_Reference.html)をご参照ください。

## Ncloud Storageの共通設定

Ncloud Storage APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://{Bucket}.{regionCode}.ncloudstorage.com
```

`Bucket`と`regionCode`の説明は次の通りです。

| 構成要素 | 必須の有無 | 説明 |
| --- | --- | --- |
| `Bucket` | Optional | バケット名 - 英字の小文字、数字、記号の「-」を組み合わせて3~63文字以内 - 先頭文字と末尾文字は英字または数字のみ使用 - 特定の接頭辞と接尾辞は使用不可: [バケット名ルール](https://guide.ncloud-docs.com/docs/ja/ncloudstorage-use-bucket#%EB%B2%84%ED%82%B7-%EC%9D%B4%EB%A6%84-%EA%B7%9C%EC%B9%99)を参照 - バケット名の確認: [ListBuckets](/docs/ja/ncloudstorage-listbuckets)を参照 |
| `regionCode` | Required | リージョンコード - `kr`: 韓国リージョン (有効値) |

              参考

              

API URLに関する次の内容をご確認ください。

- HTTP/HTTPSプロトコルをサポートします。ただし、データ保護のため、HTTPSの使用をお勧めします。
- 現在韓国リージョンをサポートしていますが、対象リージョンは継続して追加される予定です。

#### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `Authorization` | Required | 認証のための署名 - AWS Signature Version 4を使用 - NAVERクラウドプラットフォームコンソールから発行された Access Keyと Secret Keyを使用 - Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)を参照 |
| `Host` | Required | リージョンごとのエンドポイント - 例) `kr.ncloudstorage.com` |
| `x-amz-date` | Required | リクエスト日時 - ISO 8601形式(UTCを使用) |
| `Content-Length` | Conditional | リクエストボディのサイズ(Byte) - オブジェクトアップロードのリクエスト時、必須 |

### レスポンス

共通レスポンス形式を説明します。

#### レスポンスヘッダ

レスポンスヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `accept-ranges` | - | 範囲リクエスト(Range Request)をサポートするかどうか - `bytes` \| `none` - `bytes`: サポート - `none`: サポートしない |
| `connection` | - | 接続を保持するかどうか - `keep-alive` \| `close` - `keep-alive`: リクエスト完了後、接続保持 - `close`: リクエスト完了後、接続解除 |
| `Content-Length` | - | レスポンスボディサイズ(Byte) |
| `Content-Type` | - | リクエストデータの形式 |
| `date` | - | レスポンス日時 - HTTP-date形式(GMTを使用) |
| `etag` | - | オブジェクトの固有 ID(Entity Tag) |
| `last-modified` | - | 最終更新日時 - HTTP-date形式(GMTを使用) |
| `server` | - | レスポンスを返すサーバ名 - `Ncloud Storage` (有効値) |
| `x-amz-access-point-alias` | - | バケット名のタイプ - `true` \| `false` - `true`: アクセスポイントのエイリアス(Alias) - `false`: バケット名 |
| `x-amz-bucket-region` | - | バケットリージョン - `kr`: 韓国リージョン |
| `x-amz-checksum-type` | - | オブジェクトのチェックサムタイプ - `COMPOSITE` \| `FULL_OBJECT` - `COMPOSITE`: マルチパートのチェックサム - `FULL_OBJECT`: 全オブジェクトのチェックサム |
| `x-amz-delete-marker` | - | オブジェクト削除マーカーかどうか - `true` \| `false` - `true`: 削除マーカー - `false`: 一般のオブジェクト |
| `x-amz-id-2` | - | リクエスト ID - `x-amz-request-id`と一緒にトラブルシューティング時に使用 |
| `x-amz-object-size` | - | オブジェクトのサイズ(Byte) |
| `x-amz-request-id` | - | リクエスト ID - UUID形式 |
| `x-amz-version-id` | - | バージョン管理 ID - バージョン管理有効化時に表示 |

#### レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | 説明 | 課金するかどうか |
| --- | --- | --- | --- |
| 304 | NotModified | リソースが変更されていない | N |
| 400 | AuthorizationHeaderMalformed | 無効な認証情報またはリージョン情報 | N |
| 400 | AuthorizationQueryParametersError | 無効な認証クエリパラメータ | N |
| 400 | BadDigest | リクエストヘッダの Content-MD5またはチェックサム値がサーバの計算と一致しない | Y |
| 400 | EntityTooLarge | アップロードしたオブジェクトの容量が最大容量を超過 | N |
| 400 | EntityTooSmall | アップロードしたオブジェクトの容量が最小容量未満 | N |
| 400 | InvalidArgument | 無効なリクエスパラメータまたはヘッダ | N |
| 400 | InvalidBucketName | 無効な形式のバケット名 | N |
| 400 | InvalidDigest | リクエストヘッダの Content-MD5またはチェックサム値エラー | N |
| 400 | InvalidLocationConstraint | 無効なリージョン制約条件 | N |
| 400 | InvalidPart | 指定されたパートのうち、1つ以上見つからない(パートがアップロードされなかったか、ETagが一致しないパートを指定) | Y |
| 400 | InvalidPartNumber | 無効なパート番号 | Y |
| 400 | InvalidPartOrder | パートリストがパート番号の昇順でソートされていない | Y |
| 400 | InvalidRequest | 無効なリクエスト | N |
| 400 | InvalidStorageClass | 無効なストレージクラス | N |
| 400 | InvalidURI | パースできない URI | N |
| 400 | KeyTooLongError | 入力したキーの長さが許容範囲を超過 | N |
| 400 | MalformedXML | 入力した XML形式が正しくないか、公開されたスキーマが検査されていない | N |
| 400 | MetadataTooLarge | メタデータのヘッダが最大サイズを超過 | N |
| 400 | MissingRequestBodyError | リクエストボディが空である | N |
| 400 | NotImplemented | 実装されていないヘッダを入力 | N |
| 400 | RequestHeaderSectionTooLarge | リクエストヘッダとリクエストクエリパラメータが最大サイズを超過 | N |
| 400 | TooManyBuckets | 最大バケット数(100個)を超過 | N |
| 400 | XAmzContentSHA256Mismatch | x-amz-content-sha256ヘッダがサーバの計算と一致しない | N |
| 400 | InvalidEncryptionAlgorithmError | 無効な暗号化アルゴリズム | N |
| 403 | AccessDenied | アクセス権限なし | N |
| 403 | InvalidAccessKeyId | 存在しない Access Key ID | N |
| 403 | InvalidObjectState | 現在のオブジェクトの状態に対して無効な操作をリクエスト | Y |
| 403 | RequestTimeTooSkewed | リクエスト時間とサーバ時間との差が大きすぎる | N |
| 403 | SignatureDoesNotMatch | リクエストの署名値がサーバの計算と一致しない | N |
| 404 | NoSuchBucket | 存在しないバケット | N |
| 404 | NoSuchKey | 存在しない Key | Y |
| 404 | NoSuchUpload | 存在しないマルチパートアップロード(アップロード IDエラーか、マルチパートアップロードが中断/完了) | Y |
| 404 | NoSuchVersion | 存在しないバージョン ID | Y |
| 404 | NoSuchLifecycleConfiguration | 存在しないライフサイクルルール | Y |
| 405 | MethodNotAllowed | リソースに対して許可されていないメソッドをリクエスト | N |
| 409 | BucketAlreadyExists | 使用できないバケット名 | N |
| 409 | BucketAlreadyOwnedByYou | 既に所有するバケットの作成をリクエスト | Y |
| 409 | BucketNotEmpty | 空でないバケットの削除をリクエスト | Y |
| 409 | BucketNotEmptyInUnversioned | 空でないバケットの削除をリクエスト(バージョン管理は無効化状態) | N |
| 409 | RestoreAlreadyInProgress | オブジェクトの復元が既に進行中 | Y |
| 411 | MissingContentLength | Content-Lengthヘッダの欠落 | N |
| 412 | PreconditionFailed | 指定した前提条件のうち少なくとも1つが成立していない | Y |
| 416 | InvalidPartNumber | リクエストしたパート番号が有効ではない | Y |
| 416 | InvalidRange | リクエストされた範囲がリクエストに適していない | Y |
| 429 | SlowDown | 高すぎるリクエスト率 | N |
| 500 | InternalError | サーバ内部エラー | N |
| 503 | ServiceUnavailable | サービスでリクエスト処理不可 | N |

              参考

              

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

## Ncloud Storage API

Ncloud Storageサービスが提供する APIの説明は次の通りです。

### Bucket

Bucket関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [CreateBucket](/docs/ja/ncloudstorage-createbucket) | Ncloud Storageバケットを作成 |
| [GetBucketCors](/docs/ja/ncloudstorage-getbucketcors) | Ncloud Storageバケットの Cross-Origin Resource Sharing(CORS)設定を照会 |
| [GetBucketEncryption](/docs/ja/ncloudstorage-getbucketencryption) | Ncloud Storageバケットの基本サーバ側の暗号化(SSE)設定を照会 |
| [GetBucketLifecycleConfiguration](/docs/ja/ncloudstorage-getbucketlifecycleconfiguration) | Ncloud Storageバケットのライフサイクルを照会 |
| [GetBucketLocation](/docs/ja/ncloudstorage-getbucketlocation) | Ncloud Storageバケットのリージョン情報を照会 |
| [GetBucketVersioning](/docs/ja/ncloudstorage-getbucketversioning) | Ncloud Storageバケットバージョンの状態を照会 |
| [GetObjectLockConfiguration](/docs/ja/ncloudstorage-getobjectlockconfiguration) | Ncloud Storageバケットの Object Lock設定を照会 |
| [HeadBucket](/docs/ja/ncloudstorage-headbucket) | Ncloud Storageバケットのメタデータを照会 |
| [ListBuckets](/docs/ja/ncloudstorage-listbuckets) | Ncloud Storageバケットリストを照会 |
| [PutBucketCors](/docs/ja/ncloudstorage-putbucketcors) | Ncloud Storageバケットの Cross-Origin Resource Sharing(CORS)設定を変更 |
| [PutBucketEncryption](/docs/ja/ncloudstorage-putbucketencryption) | Ncloud Storageバケットの基本サーバ側の暗号化(SSE)設定を変更 |
| [PutBucketLifecycleConfiguration](/docs/ja/ncloudstorage-putbucketlifecycleconfiguration) | Ncloud Storageバケットのライフサイクルを変更 |
| [PutBucketVersioning](/docs/ja/ncloudstorage-putbucketversioning) | Ncloud Storageバケットバージョンの状態を変更 |
| [PutObjectLockConfiguration](/docs/ja/ncloudstorage-putobjectlockconfiguration) | Ncloud Storageバケットの Object Lock設定を変更 |
| [DeleteBucket](/docs/ja/ncloudstorage-deletebucket) | Ncloud Storageバケットを削除 |
| [DeleteBucketCors](/docs/ja/ncloudstorage-deletebucketcors) | Ncloud Storageバケットの Cross-Origin Resource Sharing(CORS)設定を削除 |
| [DeleteBucketEncryption](/docs/ja/ncloudstorage-deletebucketencryption) | Ncloud Storageバケットの基本サーバ側の暗号化(SSE)設定を削除 |
| [DeleteBucketLifecycle](/docs/ja/ncloudstorage-deletebucketlifecycle) | Ncloud Storageバケットのライフサイクルを削除 |

### Object

Object関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [CopyObject](/docs/ja/ncloudstorage-copyobject) | Ncloud Storageバケットに保存したオブジェクトをコピー |
| [PutObject](/docs/ja/ncloudstorage-putobject) | Ncloud Storageバケットにオブジェクトを保存 |
| [GetObject](/docs/ja/ncloudstorage-getobject) | Ncloud Storageバケットに保存したオブジェクトのダウンロードと照会 |
| [GetObjectAttributes](/docs/ja/ncloudstorage-getobjectattributes) | Ncloud Storageバケットに保存されているオブジェクトの属性を照会 |
| [HeadObject](/docs/ja/ncloudstorage-headobject) | Ncloud Storageバケットに保存したオブジェクトのメタデータを照会 |
| [ListObjects](/docs/ja/ncloudstorage-listobjects) | Ncloud Storageバケットのオブジェクトリストを照会 |
| [ListObjectsV2](/docs/ja/ncloudstorage-listobjectsv2) | Ncloud Storageバケットのオブジェクトリストを照会(最新バージョン) |
| [ListObjectVersions](/docs/ja/ncloudstorage-listobjectversions) | バージョン管理が設定されたバケットに保存したオブジェクトのすべてのバージョンのメタデータを照会 |
| [GetObjectRetention](/docs/ja/ncloudstorage-getobjectretention) | Ncloud Storageオブジェクトに設定したリテンション(Retention)情報を照会 |
| [PutObjectRetention](/docs/ja/ncloudstorage-putobjectretention) | Ncloud Storageオブジェクトにリテンション(Retention)を設定 |
| [GetObjectLegalHold](/docs/ja/ncloudstorage-getobjectlegalhold) | Ncloud Storageオブジェクトに設定したリーガルホールド(Legal Hold)状態を照会 |
| [PutObjectLegalHold](/docs/ja/ncloudstorage-putobjectlegalhold) | Ncloud Storageオブジェクトにリーガルホールド(Legal Hold)を設定 |
| [RestoreObject](/docs/ja/ncloudstorage-restoreobject) | Archive Classに保存したオブジェクトにアクセスできるようにオブジェクトを復元 |
| [DeleteObject](/docs/ja/ncloudstorage-deleteobject) | Ncloud Storageバケットに保存したオブジェクトを削除 |
| [DeleteObjects](/docs/ja/ncloudstorage-deleteobjects) | Ncloud Storageバケットに保存したオブジェクトを一括削除 |

### Multipart Upload

Multipart Upload関連 APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [CreateMultipartUpload](/docs/ja/ncloudstorage-createmultipartupload) | マルチパートアップロードを開始し、アップロード IDを返す |
| [UploadPart](/docs/ja/ncloudstorage-uploadpart) | マルチパートアップロードのパートをアップロード |
| [UploadPartCopy](/docs/ja/ncloudstorage-uploadpartcopy) | バケットに既に保存したオブジェクトをコピーしてパートでアップロード |
| [ListParts](/docs/ja/ncloudstorage-listparts) | マルチパートアップロードのパートリストを照会 |
| [ListMultipartUploads](/docs/ja/ncloudstorage-listmultipartuploads) | 進行中のマルチパートアップロードリストを照会 |
| [CompleteMultipartUpload](/docs/ja/ncloudstorage-completemultipartupload) | アップロードしたパートを組み合わせてオブジェクトを作成し、マルチパートアップロードを完了 |
| [AbortMultipartUpload](/docs/ja/ncloudstorage-abortmultipartupload) | 実行中のマルチパートアップロードを中断 |

## Ncloud Storage関連リソース

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

- Ncloud Storage APIの使用方法
  - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法
  - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): Ncloud Storageサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Ncloud Storageサービスの使用方法
  - [Ncloud Storageご利用ガイド](https://guide.ncloud-docs.com/docs/ja/ncloudstorage-overview): NAVERクラウドプラットフォームコンソールで Ncloud Storageを使用する方法
  - [Ncloud使用環境ガイド](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): Ncloud Storageに関する最新情報
  - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=STRG&categoryCode3=SV_0269&page=1): Ncloud Storageユーザーからよく寄せられる質問とその回答
  - [サポート](https://www.ncloud.com/support/question/service): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ