CreateMultipartUpload

Prev Next

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

5GB以上の大容量のオブジェクトをアップロードできるように、マルチパートアップロードを開始してアップロード IDを作成します。

参考

作成したアップロード IDは、特定のマルチパートアップロードのすべてのパートを組み合わせるのに使用されます。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /{Key}

リクエストヘッダ

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

参考

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのリクエストヘッダをご参照ください。

フィールド タイプ 必須の有無 説明
Cache-Control String Optional キャッシュ動作
Content-Disposition Optional リクエストデータの表示方法
Content-Encoding Optional リクエストデータのエンコード方法
Content-Language Optional リクエストデータの言語
Content-Type Optional リクエストデータの形式
x-amz-storage-class Optional ストレージクラス
  • STANDARD (デフォルト) | DEEP_ARCHIVE
    • STANDARD: Standard Class
    • DEEP_ARCHIVE: Archive Class
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

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
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のレスポンスヘッダをご参照ください。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
InitiateMultipartUploadResult Object - マルチパートアップロード開始の結果
InitiateMultipartUploadResult.Bucket String - バケット名
InitiateMultipartUploadResult.Key String - オブジェクト名
InitiateMultipartUploadResult.UploadId String - マルチパートアップロード ID
  • 以降の段階の API呼び出し時に必要なので、保存

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

Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Storageのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult>
    <Bucket>bucket</Bucket>
    <Key>object.xlsx</Key>
    <UploadId>7880da58-****-****-****-9cc2c468d0e9</UploadId>
</InitiateMultipartUploadResult>