--- title: "CreateMultipartUpload" slug: "ncloudstorage-createmultipartupload" updated: 2026-10-08T07:18:07Z published: 2026-10-08T07:18:07Z canonical: "api.ncloud-docs.com/ncloudstorage-createmultipartupload" --- > ## 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. # CreateMultipartUpload Classic/VPC環境で利用できます。 5GB以上の大容量のオブジェクトをアップロードできるように、マルチパートアップロードを開始してアップロード IDを作成します。 参考 作成したアップロード IDは、特定のマルチパートアップロードのすべてのパートを組み合わせるのに使用されます。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | POST | /{Key} | ### リクエストヘッダ リクエストヘッダの説明は次の通りです。 参考 Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのリクエストヘッダ](/docs/ja/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `Cache-Control` | Optional | キャッシュ動作 | | `Content-Disposition` | Optional | リクエストデータの表示方法 | | `Content-Encoding` | Optional | リクエストデータのエンコード方法 | | `Content-Language` | Optional | リクエストデータの言語 | | `Content-Type` | Optional | リクエストデータの形式 | | `x-amz-storage-class` | Optional | ストレージクラス - `STANDARD` (デフォルト) \| `ONEZONE_IA` \| `DEEP_ARCHIVE` - `STANDARD`: Standard Class - `ONEZONE_IA`: One Zone-IA(Infrequent Access) Class - `DEEP_ARCHIVE`: Archive Class | | `x-amz-server-side-encryption` | Optional | サーバ側の暗号化方式 - `AES256`: SSE-S3 (サーバ管理キー) - `aws:kms`: SSE-KMS (KMS管理キー) | | `x-amz-server-side-encryption-customer-algorithm` | Optional | ユーザー暗号化アルゴリズム (AES256) | | `x-amz-server-side-encryption-customer-key` | Optional | ユーザー提供の暗号化キー | | `x-amz-server-side-encryption-customer-key-MD5` | Optional | ユーザー提供暗号化キーの MD5 | | `x-amz-object-lock-mode` | Optional | オブジェクトのリテンションモード - `GOVERNANCE` \| `COMPLIANCE` - `GOVERNANCE`: 特別な権限でバイパス可能 - `COMPLIANCE`: いかなるユーザーもバイパス不可 - `x-amz-object-lock-retain-until-date`と併せて指定 - Object Lockが有効になっているバケットでのみ使用可能 | | `x-amz-object-lock-retain-until-date` | Optional | オブジェクトのリテンション期限 - ISO 8601形式 - `x-amz-object-lock-mode`と併せて指定 - Object Lockが有効になっているバケットでのみ使用可能 | | `x-amz-object-lock-legal-hold` | Optional | リーガルホールドの状態 - `ON` \| `OFF` - Object Lockが有効になっているバケットでのみ使用可能 | ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Key` | String | Required | オブジェクト名 - バケット内フォルダに保存する場合、`{フォルダ名}/{ファイル名}`形式で入力 | ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `uploads` | String | Required | マルチパートアップロードの開始リクエスト - 値なしでキーだけ入力 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` POST /object.xlsx?uploads HTTP/1.1 Host: bucket.kr.ncloudstorage.com x-amz-storage-class: DEEP_ARCHIVE ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのレスポンスヘッダ](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `InitiateMultipartUploadResult` | Object | - | マルチパートアップロード開始の結果 | | `InitiateMultipartUploadResult.Bucket` | String | - | バケット名 | | `InitiateMultipartUploadResult.Key` | String | - | オブジェクト名 | | `InitiateMultipartUploadResult.UploadId` | String | - | マルチパートアップロード ID - 以降の段階の API呼び出し時に必要なので、保存 | ### レスポンスステータスコード Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Storageのレスポンスステータスコード](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK bucket object.xlsx 7880da58-****-****-****-9cc2c468d0e9 ```