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}

リクエストパラメータ

この操作では以下のリクエストパラメータを使用します。

表. List Multipart Uploads リクエストパラメータ一覧
名前 説明 必須
delimiter
オブジェクト階層の区切り文字
このパラメータで指定された文字を「階層の区切り文字」として、リクエストで指定したURIに存在するオブジェクトのキーのリストを返します。
この時、返されるキーは「階層の区切り文字」で切り捨てられます。
具体的な内容については、 GET Bucketdelimiter パラメータについて をご覧ください。
型:String
×
max-uploads
レスポンスに含めるマルチパートアップロードの最大件数
条件に一致するマルチパートアップロードが max-uploads に満たない場合は、一致する全てのマルチパートアップロードを返します。また、 max-uploads より多くのマルチパートアップロードが一致した場合は、レスポンスエレメントの IsTruncated に真をセットし、 max-uploads の件数分のマルチパートアップロードを辞書順に先頭から選択し返します。
型:Integer
デフォルト値:1000
×
key-marker
リストの開始位置を指定するオブジェクトキーのマーカー文字列
リストされたキーのうち、オブジェクトキーを辞書順で並べた際に、ここで指定されたオブジェクトキーより後のもののみをリストに含めます(指定文字列と同名のキーは含まれません)。
型:String
×
prefix
レスポンスに含めるオブジェクトキーを前方一致でフィルタする為の文字列
URI(バケット名指定がURI形式の場合、バケット名より後ろ)の文字列に対して前方一致のフィルタを行います。
型:String
×
upload-id-marker
リストの開始位置を指定するアップロードIDのマーカー文字列
key-marker と同時に使用した場合、アップロードIDを辞書順で並べてこの指定値より後のマルチパートアップロードをリストに含めます。(指定文字列と同名のアップロードIDは含まれません)。 key-marker の指定が無い場合には、 upload-id-marker は無視されます。
型:String
×

リクエストヘッダー

この操作では基本リクエストヘッダーのみ使用します。

リクエストエレメント

この操作ではリクエストエレメントは使用しません。

レスポンス情報

レスポンスヘッダー

この操作では基本レスポンスヘッダーのみ返します。

レスポンスエレメント

この操作では以下のレスポンスエレメントを返します。

表. List Multipart Uploads レスポンスエレメント一覧
名前 説明
ListMultipartUploadsResult
レスポンスのルート要素となるコンテナ
型:Container
親:なし
Bucket
マルチパートアップロードの開始時に指定したバケット名
型:String
親:ListMultipartUploadsResult
KeyMarker
リストの開始位置を指定するオブジェクトキーのマーカー文字列

リクエストでkey-markerに指定した値です。オブジェクトのキーが(アルファベット順で)これより後のオブジェクトのみリストに含めます。

型:String
親:ListMultipartUploadsResult
UploadIdMarker
リストの開始位置を指定するアップロードIDのマーカー文字列

リクエストでupload-id-markerに指定した値です。

型:String
親:ListMultipartUploadsResult
NextKeyMarker
レスポンスに含まれるマルチパートアップロードのリストが部分的なものだった場合に、ページングで次の一覧の開始位置を指定するオブジェクトキーのマーカー文字列
型:String
親:ListMultipartUploadsResult
NextUploadIdMarker
レスポンスに含まれるマルチパートアップロードのリストが部分的なものだった場合に、ページングで次の一覧の開始位置を指定するアップロードIDのマーカー文字列
型:String
親:ListMultipartUploadsResult
MaxUploads
レスポンスに含まれるマルチパートアップロードのリストの最大件数

リクエストでmax-keysに指定した値です。

型:Integer
親:ListMultipartUploadsResult
IsTruncated
マルチパートアップロードの一覧が部分的なものかどうか
この値が true の場合、レスポンスに含まれるマルチパートアップロードの一覧は部分的なものであり、 MaxUploads 以上に存在することを意味します。
以降の結果を取得するには、 NextKeyMarker および UploadIdMarker を使用して再び List Multipart Upload をリクエストしてください。
型:Boolean
親:ListMultipartUploadsResult
Upload
マルチパートアップロードに関連する要素を含むコンテナ
型:String
親:ListMultipartUploadsResult
Key
マルチパートアップロード開始時に指定したオブジェクトキー
型:String
親:Upload
UploadId
マルチパートアップロードの識別子
型:String
親:Upload
Initiator
マルチパートアップロードを開始したユーザ情報を含むコンテナ
型:Container
親:Upload
ID
アカウントの識別ID
型:Container
親:Initiator, Owner
DisplayName
アカウントの表示名
型:Container
親:Initiator, Owner
Owner
オブジェクト所有者の情報を含むコンテナ
型:Container
親:Upload
StorageClass
ストレージのクラス

本サービスでは常にSTANDARDを返します。

型:String
親:Upload
Initiated
マルチパートアップロードの開始日時
型:Date
親:Upload
ListMultipartUploadsResult.Prefix
オブジェクトのキーを前方一致でフィルタリングする文字列
型:String
親:ListMultipartUploadsResult
Delimiter
リクエストでデリミタに指定した値
型:String
親:ListBucketResult
CommonPrefixes
Prefix 直下の仮想的なサブディレクトリのリストを持つコンテナ

リクエストでPrefixおよびdelimiterを指定した場合にのみ含まれます。

型:Container
子:CommonPrefixes.Prefix
親:ListMultipartUploadsResult
CommonPrefixes.Prefix
Prefix 直下の仮想的なサブディレクトリのリストを持つコンテナ

リクエストでPrefixおよびdelimiterを指定した場合にのみ含まれます。

型:Container
子:Prefix
親:CommonPrefixes

エラー情報

この操作は共通のエラーレスポンスを返します。詳しくはエラーコード一覧をご覧ください。

サンプル

最大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>

ページ先頭へ