UploadPart

最終更新日:2025-08-18 15:54:01

アップロードタスクの説明

  1. マルチパートアップロードタスクが作成された後、ユーザーはそのタスク番号を指定し、クライアントから新しいデータ(パート)をアップロードできます。パートアップロードインターフェースを利用して、特定のタスクにパートを追加します。同一オブジェクトの同じマルチパートアップロードタスクに対しては、アップロード順序がマージ操作に影響を与えないため、複数パートの同時(並行)アップロードが可能です。

  2. アップロードするパートの番号には範囲制限があり、[1,10000]となります。パート番号はマージ時にパートとその位置を識別する唯一の方法です。同じパート番号で再度アップロードすると、既存のパートは上書きされます。各パートの最小サイズは5MBですが、マージ時の最後のパートにはサイズ制限はありません。

  3. データ転送中の破損を防ぐため、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

URIリクエストパラメータ

パラメータ名 説明 必須
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