公開
マニュアル一覧へ

ご契約者向け
マニュアル一覧へ

IIJ IoTサービス オンラインマニュアル

List Parts

指定の進行中のマルチパートアップロードに対してアップロードした全てのパートをリストで返します。
この操作を行うには、リクエストに進行中のマルチパートアップロードのアップロードIDをリクエストパラメータに指定する必要があります。
この操作は、 GET Bucket (List Objects) と同様のページング機能をサポートしています。 パートの一覧は最大1000件返すことができ、 max-parts パラメータを変更することでリストに含まれるパートの最大件数を変更することができます（デフォルトは1000件です）。 もしリクエストに該当するパートの件数が最大件数を越える場合には、リストが部分的なものであることを示す IsTruncated 要素の値を true にしてレスポンスを返します。 部分的なリストの場合には part-number-marker を指定し、次のリストを取得することができます。

この操作を行う利用者は、バケット所有者か対象バケットに対してバケットポリシーの dag:ListMultipartUploadParts 権限を付与されている必要があります。
デフォルトではバケット所有者のみこの操作が許可されており、バケット所有者はバケットポリシーによって他のアカウントに権限を付与することができます。

 

リクエスト情報

シンタックス
GET /{bucket name}/{object key}?uploadId={upload ID} HTTP/1.1
Host: s3api.iot.iij.jp
Date: {date}
Authorization: {authorization string}

 

リクエストパラメータ

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

表. List Parts リクエストパラメータ一覧

名前説明必須
uploadId

パートの一覧を取得するマルチパートアップロードのアップロードID

  • 型:String
○
max-parts

レスポンスに含めるパートの最大件数

条件に一致するマルチパートアップロードのパートが max-parts に満たない場合は、一致する全てのマルチパートアップロードのパートを返します。 また、 max-parts より多くのパートが一致した場合は、レスポンスエレメントの IsTruncated に真をセットし、 パート番号で辞書順にソートしたパートのリストから max-parts の件数分のパートを返します。

  • 型:Integer
  • デフォルト値:1000
×
part-number-marker

リストの開始位置となるパート番号

パート番号を辞書順で並べてこの指定値より後のパートをリストに含めます。(指定したパート番号と同名のパートは含まれません)。

  • 型:String
×
リクエストヘッダー

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

リクエストエレメント

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

 

レスポンス情報

レスポンスヘッダー

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

レスポンスエレメント

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

表. List Parts レスポンスエレメント一覧

名前説明
ListPartsResult

レスポンスのルート要素となるコンテナ

  • 型:Container
  • 親:なし
Bucket

マルチパートアップロードの開始時に指定したバケット名

  • 型:String
  • 親:ListPartsResult
Key

マルチパートアップロードの開始時に指定したオブジェクトキー

  • 型:String
  • 親:ListPartsResult
UploadId

マルチパートアップロードの識別子リクエストで upload-id-marker に指定した値です。

  • 型:String
  • 親:ListPartsResult
MaxParts

レスポンスに含まれるパートのリストの最大件数リクエストで max-keys に指定した値です。

  • 型:Integer
  • 親:ListPartsResult
PartNumberMarker

レスポンスに含まれるパートのリストが部分的なものだった場合に、ページングで次の一覧の開始位置を指定するパート番号のマーカー

  • 型:String
  • 親:ListPartsResult
IsTruncated

パートのリストが部分的なものかどうか

この値が true の場合、レスポンスに含まれるパートのリストは部分的なものであり、 MaxParts 以上に存在することを意味します。以降の結果を取得するには、 NextPartNumberMarker を PartNumberMarker に指定して再び List Multipart Upload をリクエストしてください。

  • 型:Boolean
  • 親:ListPartsResult
StorageClass

ストレージのクラス本サービスでは常に STANDARD を返します。

  • 型:String
  • 親:ListPartsResult
Initiator

マルチパートアップロードを開始したユーザ情報を含むコンテナ

  • 型:Container
  • 親:ListPartsResult
Part

マルチパートアップロードのパートに関連する要素を含むコンテナ

  • 型:String
  • 親:ListPartsResult
PartNumber

パートの識別子となるパート番号

  • 型:String
  • 親:Part
LastModified

パートをアップロードした日時

  • 型:String
  • 親:Part
ETag

パートのMD5のハッシュ値

  • 型:Container
  • 親:Part
Size

パートのファイルサイズ

  • 型:Container
  • 親:Part
ID

アカウントの識別子

  • 型:Container
  • 親:Initiator, Owner
DisplayName

アカウントの表示名

  • 型:Container
  • 親:Initiator, Owner
Owner

オブジェクト所有者の情報を含むコンテナ

  • 型:Container
  • 親:Upload
エラー情報

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

 

サンプル 

パート番号1より後のパートのリストを最大2件取得するサンプル

リクエスト
GET /mybucket/myobject?uploadId=y0cHiwKZjrrJZBC3qyClgpfMPjowQTVcbLRFMafoHCnJHAL&max-parts=2&part-number-marker=1 HTTP/1.1
Host: s3api.iot.iij.jp
Date: Wed, 1 Oct 2014 00:00:00 GMT
Authorization: IIJGIO 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=
レスポンス

以下のレスポンスでは、進行中のマルチパートアップロードが2件以上存在するため、部分的な一覧( IsTruncated = true )として返ってきています。

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: s3api.iot.iij.jp

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://acs.dag.iijgio.com/doc/2006-03-01/">
  <Bucket>mybucket</Bucket>
  <Key>myobject</Key>
  <UploadId>y0cHiwKZjrrJZBC3qyClgpfMPjowQTVcbLRFMafoHCnJHAL</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>
  <PartNumberMarker>1</PartNumberMarker>
  <NextPartNumberMarker>3</NextPartNumberMarker>
  <MaxParts>2</MaxParts>
  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2010-11-10T20:48:34.000Z</LastModified>
    <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>3</PartNumber>
    <LastModified>2010-11-10T20:48:33.000Z</LastModified>
    <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
    <Size>10485760</Size>
  </Part>
</ListPartsResult>