--- title: "create-multipart-upload" slug: "create-multipart-upload" updated: 2026-10-08T09:47:23Z published: 2026-10-08T09:47:23Z canonical: "cli.ncloud-docs.com/create-multipart-upload" --- > ## 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. # create-multipart-upload Classic/VPC環境で利用できます。 5GB以上の大容量のオブジェクトをアップロードできるように、マルチパートアップロードを開始してアップロード IDを作成します。 参考 Sub Accountユーザーがこのコマンドを実行するには、Change/PutObjectアクションの権限が必要です。 ## 構文 `create-multipart-upload`構文は次の通りです。 ``` aws s3api create-multipart-upload \ --bucket \ --key \ [--cache-control ] \ [--content-disposition ] \ [--content-encoding ] \ [--content-language ] \ [--content-type ] \ [--metadata ] \ [--storage-class ] \ [--server-side-encryption ] \ [--sse-customer-algorithm ] \ [--sse-customer-key ] \ [--sse-customer-key-md5 ] \ [--object-lock-mode ] \ [--object-lock-retain-until-date ] \ [--object-lock-legal-hold-status ] \ --endpoint-url ``` ## オプション `create-multipart-upload`の実行時に指定できるオプションについて説明します。 ### 必須オプション `create-multipart-upload`の必須オプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--bucket` | String | Required | バケット名 | | `--key` | String | Required | オブジェクト名 | ### 任意オプション `create-multipart-upload`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--cache-control` | String | Optional | キャッシュ動作 | | `--content-disposition` | String | Optional | リクエストデータの表示方法 | | `--content-encoding` | String | Optional | リクエストデータのエンコード方法 | | `--content-language` | String | Optional | リクエストデータの言語 | | `--content-type` | String | Optional | リクエストデータの形式 | | `--metadata` | String | Optional | オブジェクトと併せて保存するメタデータ | | `--storage-class` | String | Optional | ストレージクラス - `STANDARD` (デフォルト) \| `ONEZONE_IA` \| `DEEP_ARCHIVE` - `STANDARD`: Standard Class - `ONEZONE_IA`: One Zone-IA(Infrequent Access) Class - `DEEP_ARCHIVE`: Archive Class | | `--server-side-encryption` | String | Optional | サーバ側暗号化方式 - `AES256` \| `aws:kms` - `AES256`: SSE-S3(サーバ管理キー) - `aws:kms`: SSE-KMS(KMS管理キー) | | `--sse-customer-algorithm` | String | Optional | ユーザー暗号化アルゴリズム (AES256) | | `--sse-customer-key` | String | Optional | ユーザー提供の暗号化キー | | `--sse-customer-key-md5` | String | Optional | ユーザー提供暗号化キーの MD5 | | `--object-lock-mode` | String | Optional | オブジェクトのリテンションモード - `GOVERNANCE` \| `COMPLIANCE` - `GOVERNANCE`: 特別な権限でバイパス可能 - `COMPLIANCE`: いかなるユーザーもバイパス不可 - `--object-lock-retain-until-date`と併せて指定 - Object Lockが有効になっているバケットでのみ使用可能 | | `--object-lock-retain-until-date` | String | Optional | オブジェクトのリテンション期限 - ISO 8601形式 - `--object-lock-mode`と併せて指定 - Object Lockが有効になっているバケットでのみ使用可能 | | `--object-lock-legal-hold-status` | String | Optional | リーガルホールドの状態 - `ON` \| `OFF` - Object Lockが有効になっているバケットでのみ使用可能 | ### 共通オプション `aws`コマンドで共通して使用するオプションについては、[Ncloud Storageのオプション](/docs/ja/storage-ncloudstorage#%EC%98%B5%EC%85%98)をご参照ください。 ## 例 マルチパートアップロードの開始リクエストが成功すると、以降の段階で使用するアップロードの識別情報が返されます。 ### コマンド コマンドの例は次の通りです。 ``` aws s3api create-multipart-upload --bucket my-test-bucket \ --key large.bin \ --endpoint-url=https://kr.ncloudstorage.com ``` ### 出力 出力の例は次の通りです。 ``` { "ServerSideEncryption": "AES256", "Bucket": "my-test-bucket", "Key": "large.bin", "UploadId": "11111111-2222-3333-4444-555555555554" } ``` ## 関連コマンド 関連コマンドは次の通りです。 - [upload-part](/docs/ja/upload-part) - [complete-multipart-upload](/docs/ja/complete-multipart-upload) - [abort-multipart-upload](/docs/ja/abort-multipart-upload) - [list-parts](/docs/ja/list-parts) - [list-multipart-uploads](/docs/ja/list-multipart-uploads)