CompleteMultipartUpload

Prev Next

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

アップロードされたパートを組み合わせてオブジェクトを保存し、マルチパートアップロードを完了します。

リクエスト

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

メソッド URI
POST /{Key}

リクエストヘッダ

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

参考

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

フィールド 必須の有無 説明
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 オブジェクト名

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

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

フィールド タイプ 必須の有無 説明
uploadId String Required マルチパートアップロード ID

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
CompleteMultipartUpload Object Required マルチパートアップロード完了リクエスト
CompleteMultipartUpload.Part Array Required パートリスト

Part

Partの説明は次の通りです。

フィールド タイプ 必須の有無 説明
PartNumber Integer Optional パート番号
  • 1~10,000
ETag String Optional オブジェクトの固有 ID(Entity tag)

リクエスト例

リクエストのサンプルコードは次の通りです。

POST /object.zip?uploadId=f228bfca-****-****-****-9cc2c468d0e9 HTTP/1.1
Host: bucket.kr.ncloudstorage.com

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUpload>
    <Part>
        <PartNumber>1</PartNumber>
        <ETag>&#34;a068860ac17***********d5d7fd3334&#34;</ETag>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <ETag>&#34;a068860ac17***********d5d7fd3334&#34;</ETag>
    </Part>
</CompleteMultipartUpload>

レスポンス

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

レスポンスヘッダ

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
CompleteMultipartUploadResult Object - マルチパートアップロード完了の結果
CompleteMultipartUploadResult.Bucket String - バケット名
CompleteMultipartUploadResult.Key String - オブジェクト名
CompleteMultipartUploadResult.ETag String - オブジェクトの固有 ID(Entity Tag)
CompleteMultipartUploadResult.Location String - アップロード先
CompleteMultipartUploadResult.ChecksumCRC64NVME String - CRC64チェックサム値
CompleteMultipartUploadResult.ChecksumType String - オブジェクトのチェックサム計算タイプ
  • COMPOSITE | FULL_OBJECT
    • COMPOSITE: マルチパートのチェックサム
    • FULL_OBJECT: 全オブジェクトのチェックサム

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

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

レスポンス例

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

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult>
    <Bucket>bucket</Bucket>
    <Key>object.zip</Key>
    <ETag>&#34;1f75ca9b7e6***********645f438f93-1&#34;</ETag>
    <Location>/bucket000/object000.zip</Location>
    <ChecksumCRC64NVME>WU7+G*******</ChecksumCRC64NVME>
    <ChecksumType>FULL_OBJECT</ChecksumType>
</CompleteMultipartUploadResult>