InitiateMultipartUpload_API_Object Storage-CDNetworks ドキュメント

マルチパートアップロードを利用する場合、まず Initiate Multipart Upload インターフェースを呼び出してタスクを作成する必要があります。システムは、グローバルで一意なマルチパートアップロードタスク番号（uploadId）をタスク識別子として返します。以降の処理は、この識別子に基づいて、パートのアップロード、パートの結合、パートの一覧取得などを実行します。同じオブジェクトに対して複数のマルチパートアップロードタスクを同時に持つことができ、それぞれのタスクは追加のメッセージヘッダー情報で初期化可能です。

IAM wos:PutObject 権限が必要です。

リクエスト構文

POST /ObjectName?uploads HTTP/1.1
Host: Bucket.Endpoint
Date: date
Authorization: authorization

Cache-Control: CacheControl
Content-Disposition: ContentDisposition
Content-Encoding: ContentEncoding
Content-Language: ContentLanguage
Content-Length: ContentLength
Content-MD5: ContentMD5
Content-Type: ContentType
Expires: Expires

URIリクエストパラメータ

なし

リクエストヘッダー

common request headers に加え、下記もサポートしています。

パラメータ	説明	必須
Content-MD5	元データのMD5値。転送中にデータが破損し、MD5が一致しない場合は403 SignatureDoesNotMatchで応答されます。	No
x-wos-storage-class	ファイルの保存タイプを指定します。Standard（標準ストレージ）、IA（低頻度アクセス）、Archive（アーカイブストレージ）。同一スペース内ではデフォルトのストレージタイプ。	No
x-wos-meta-*	カスタムメタデータ。headObject または getObject 呼び出し時にそのまま返却されます。	No

リクエストボディ

なし

レスポンス構文

HTTP/1.1 status_code

x-wos-request-id: request id
Date: date
Content-Length: length
Connection: status

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <InitiateMultipartUploadResult xmlns="https://www.wangsu.com/document">
    <Bucket>BucketName</Bucket>
    <Key>ObjectName</Key>
    <UploadId>uploadID</UploadId>
</InitiateMultipartUploadResult>

レスポンスヘッダー

common response headers のみご利用ください。

レスポンス要素

要素名	説明
InitiateMultipartUploadResult	マルチパートアップロードタスクを記述するコンテナ型：XML 子ノード：Bucket, Key, UploadId 親ノード: なし
Bucket	マルチパートアップロードオブジェクトが存在するスペース名型：文字列親ノード：InitiateMultipartUploadResult
Key	マルチパートアップロードオブジェクトのキー型：文字列親ノード：InitiateMultipartUploadResult
UploadId	マルチパートアップロードID。後続のマルチパートアップロード処理ではこのIDを指定します型：文字列親ノード：InitiateMultipartUploadResult

特殊エラー

状況	Http Status	エラーコード	メッセージ
シグネチャ付きで uploads がある or 無い、URLに不整合がある場合	403 Forbidden	SignatureDoesNotMatch	The request signature we calculated does not match the signature
シグネチャまたはURLの uploads にスペルミスや不整合がある場合	403 Forbidden	SignatureDoesNotMatch	The request signature we calculated does not match the signature you provided.
シグネチャとURLの双方に uploads があるがスペル不一致	403 Forbidden	SignatureDoesNotMatch	The request signature we calculated does not match the signature you provided.

例

POST /objectkey?uploads HTTP/1.1

Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Apr 2017 20:34:56 GMT
Authorization: WOS AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc=

HTTP/1.1 200 OK

x-wos-request-id: 996c76696e6727732072657175657374
Date: Mon, 1 Apr 2017 20:34:56 GMT
Content-Length: 146
Connection: keep-alive

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <InitiateMultipartUploadResult xmlns="https://www.wangsu.com/document">
    <Bucket>bucket01</Bucket>
    <Key>objectkey</Key>
    <UploadId>DCD2FC98B4F70000013DF578ACA318E7</UploadId>
</InitiateMultipartUploadResult>

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

InitiateMultipartUpload