最終更新日:2025-08-18 15:54:01
マルチパートアップロードタスクが作成された後、ユーザーはそのタスク番号を指定し、クライアントから新しいデータ(パート)をアップロードできます。パートアップロードインターフェースを利用して、特定のタスクにパートを追加します。同一オブジェクトの同じマルチパートアップロードタスクに対しては、アップロード順序がマージ操作に影響を与えないため、複数パートの同時(並行)アップロードが可能です。
アップロードするパートの番号には範囲制限があり、[1,10000]となります。パート番号はマージ時にパートとその位置を識別する唯一の方法です。同じパート番号で再度アップロードすると、既存のパートは上書きされます。各パートの最小サイズは5MBですが、マージ時の最後のパートにはサイズ制限はありません。
データ転送中の破損を防ぐため、Content-MD5リクエストヘッダーを追加することができます。システムはMD5値を検証し、不一致の場合はエラーを返します。
注意: マルチパートタスクを作成し、一つ以上のパートをアップロードした場合、パートのマージやタスクのキャンセルを行った場合にのみ、その使用していたストレージ領域が解放されます。いずれも行われなかった場合、ストレージは解放されません。
PUT /ObjectName?partNumber=partNum&uploadId=uploadId HTTP/1.1
Host: Bucket.Endpoint
Date: date
Content-Length: Size
Authorization: authorization
Content-MD5: md5
| パラメータ名 | 説明 | 必須 |
|---|---|---|
| partNumber | アップロードするパートの番号。範囲:[1,10000] | Yes |
| uploadId | Initiate Multipart Upload レスポンス時のアップロードID | Yes |
common request headers のみを使用してください。
分割データ
HTTP/1.1 status_code
x-wos-request-id: request id
Date: date
ETag: etagValue
Content-Length: length
Server: : WS-web-server
common response headers のみを使用してください。
なし
| 状況 | Http Status | エラーコード | メッセージ |
|---|---|---|---|
| signatureおよびURLのパラメータが片方のみ(uploadIdまたはpartNumberのみ) | 400 Bad Request | InvalidArgument | Invalid Argument |
| signatureおよびURLにuploadId/partNumber両方があるが、順序が正常でない場合 | 400 Bad Request | InvalidArgument | Invalid Argument |
| partNumber>10000 | 400 Bad Request | InvalidArgument | Part number must be an integer between 1 and 10000 |
| 1回のパートアップロードデータのサイズが5GB以上 | 400 Bad Request | EntityTooLarge | Your proposed upload exceeds the maximum allowed object size. |
PUT /ObjectName?partNumber=1&uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 1048596
Authorization:WOS 14RZT432N80TGDF2Y2G2:8se2hm3YLchJhuPMDrybeITcuo0=
Content-MD5:q3q7DaS8pTI6thGbtdzSlg==
HTTP/1.1 200 OK
x-wos-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
ETag: "b54357faf0632cce46e942fa68356b38"
Content-Length: 1048596
Server:WCS-web-server