List Multipart Uploads¶
進行中マルチパートアップロードの一覧を返します。
Note
進行中のマルチパートアップロードとは、Initiate Multipart Uploadによって開始(初期化)され、完了(Complete Multipart Upload)または中止(Abort Multipart Upload)していないマルチパートアップロードを差します。
この操作は、GET Bucket (List Objects)と同様のページング機能をサポートしています。一度に最大1000個のマルチパートアップロードの一覧を取得し、key-markerパラメータを指定して次のリストを取得します。また、一度に取得するマルチパートアップロードの数はmax-uploadsパラメータで変更することができます。
リクエスト情報¶
シンタックス¶
GET /?uploads HTTP/1.1
Host: {bucket name}.storage-dag.iijgio.com
Date: {date}
Authorization: {authorization string}
リクエストパラメータ¶
この操作では以下のリクエストパラメータを使用します。
名前 | 説明 | 必須 | ||||
---|---|---|---|---|---|---|
delimiter |
|
× | ||||
max-uploads |
|
× | ||||
key-marker |
|
× | ||||
prefix |
|
× | ||||
upload-id-marker |
|
× |
リクエストヘッダー¶
この操作では基本リクエストヘッダーのみ使用します。
リクエストエレメント¶
この操作ではリクエストエレメントは使用しません。
レスポンス情報¶
レスポンスヘッダー¶
この操作では基本レスポンスヘッダーのみ返します。
レスポンスエレメント¶
この操作では以下のレスポンスエレメントを返します。
名前 | 説明 | ||||||
---|---|---|---|---|---|---|---|
ListMultipartUploadsResult |
|
||||||
Bucket |
|
||||||
KeyMarker |
|
||||||
UploadIdMarker |
|
||||||
NextKeyMarker |
|
||||||
NextUploadIdMarker |
|
||||||
MaxUploads |
|
||||||
IsTruncated |
|
||||||
Upload |
|
||||||
Key |
|
||||||
UploadId |
|
||||||
Initiator |
|
||||||
ID |
|
||||||
DisplayName |
|
||||||
Owner |
|
||||||
StorageClass |
|
||||||
Initiated |
|
||||||
ListMultipartUploadsResult.Prefix |
|
||||||
Delimiter |
|
||||||
CommonPrefixes |
|
||||||
CommonPrefixes.Prefix |
|
サンプル¶
最大3件のマルチパートアップロードの一覧で取得する¶
max-uploadsパラメータに3を指定しリクエストします。
リクエスト¶
GET /?uploads&max-uploads=3 HTTP/1.1
Host: mybucket.storage-dag.iijgio.com
Date: Wed, 1 Oct 2014 00:00:00 GMT
Authorization: IIJGIO 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=
レスポンス¶
以下のレスポンスでは、進行中のマルチパートアップロードが4件以上存在するため、部分的な一覧(IsTruncated = true)として返ってきています。また、my-upload_2.zipとして進行中のマルチパートアップロードが2件あるため、UploadIdで辞書順にソートされています。
HTTP/1.1 200 OK
x-iijgio-id-2: eftixk72aD6Ap51TnqcoF8eFidJG9Z/2mkiDFu8yU9AS1ed4OpIszj7UDNEHGran
x-iijgio-request-id: 318BC8BC148832E5
Date: Wed, 1 Oct 2014 00:00:00 GMT
Content-Length: 1330
Connection: keep-alive
Server: storage-dag.iijgio.com
<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://acs.dag.iijgio.com/doc/2006-03-01/">
<Bucket>mybucket</Bucket>
<KeyMarker></KeyMarker>
<UploadIdMarker></UploadIdMarker>
<NextKeyMarker></NextKeyMarker>
<NextUploadIdMarker>y0cHiwKZjrrJZBC3qyClgpfMPjowQTVcbLRFMafoHCnJHAL</NextUploadIdMarker>
<MaxUploads>3</MaxUploads>
<IsTruncated>true</IsTruncated>
<Upload>
<Key>my-upload_1.zip</Key>
<UploadId>PEzcwtbrQQU8gFzGDVH3JTm3o2YjPWbYt1ilTp65wUsYJ1C</UploadId>
<Initiator>
<ID>3xqvsfypbm4t5yljpydldixooivd46ne</ID>
<DisplayName>taro@iij.ad.jp</DisplayName>
</Initiator>
<Owner>
<ID>3xqvsfypbm4t5yljpydldixooivd46ne</ID>
<DisplayName>taro@iij.ad.jp</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2010-11-10T20:48:33.000Z</Initiated>
</Upload>
<Upload>
<Key>my-upload_2.zip</Key>
<UploadId>9hXi0elgsVDLD0BEswAJmenhjnmQJ5n5iqBz353CNTMZcJy</UploadId>
<Initiator>
<ID>3xqvsfypbm4t5yljpydldixooivd46ne</ID>
<DisplayName>taro@iij.ad.jp</DisplayName>
</Initiator>
<Owner>
<ID>3xqvsfypbm4t5yljpydldixooivd46ne</ID>
<DisplayName>OwnerDisplayName</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2010-11-10T20:48:33.000Z</Initiated>
</Upload>
<Upload>
<Key>my-upload_2.zip</Key>
<UploadId>y0cHiwKZjrrJZBC3qyClgpfMPjowQTVcbLRFMafoHCnJHAL</UploadId>
<Initiator>
<ID>hciff0ce2w49shhjz61n1q2k6165mp63</ID>
<DisplayName>jiro@iij.ad.jp</DisplayName>
</Initiator>
<Owner>
<ID>hciff0ce2w49shhjz61n1q2k6165mp63</ID>
<DisplayName>jiro@iij.ad.jp</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2010-11-10T20:49:33.000Z</Initiated>
</Upload>
</ListMultipartUploadsResult>