KDDIクラウドプラットフォームサービス ナレッジサイト

  • HOME
  • 開発者ガイドブック(APIリファレンス)
  • オブジェクトストレージ
  • サービス操作
  • オブジェクト操作
  • List Part

List Part

処理概要

アップロードIDを指定して、マルチパートアップロードでアップロード済のパーツリストを取得する。

リクエスト

リクエストパラメタ

GETで利用できるパラメタは下記になります。

Name Type Description Required
encoding-type string レスポンスをエンコードするために要求し、使用するエンコード方式を指定します。 No
uploadId string アップロードIDは、リスト済のパートのマルチパートアップロードを区別するものです。 Yes
max-parts string レスポンスボディでパーツの最大値を設定します。 No
part-number-marker string 指定したパーツ番号以降をリスト化します No

リクエストヘッダー

このオペレーションはすべての操作に共通するリクエストヘッダのみを使用しています。詳細については、一般的なリクエストヘッダを参照してください。

リクエストボディ

なし

リクエストサンプル

GET /sample-bucket/sample-object.txt?uploadId=12345678-9abc-def0-1234-56789abcdef0 HTTP/1.1
Host: 192.168.0.1
Connection: keep-alive
Date: Tue, 01 Sep 2015 10:00:00 +0000
Authorization: AWS EXAMPLEjU2So5By3H5v2:EXAMPLEAjwlAvEi2cPLfQaM588ROWW90so7LwfPr

レスポンス

レスポンスヘッダ

このオペレーションはすべての操作に共通するレスポンスヘッダのみを使用しています。詳細については、一般的なレスポンスヘッダを参照してください。

レスポンスボディ

Name Type Description
ListPartsResult container レスポンスのコンテナ
Bucket sring マルチパートアップロードを開始したbucketの名前
Encoding-Type string レスポンスにあるobjectのエンコードタイプ
Key string マルチパートアップロードを開始したobjectのキー名
UploadId string アップロードID
Initiator container マルチパートアップロードを開始したユーザーのコンテナ。内容はOwnerと同様。
ID string 認証済ユーザーID
DisplayName string スクリーン名
Owner container スクリーン名とIDのコンテナ
StorageClass string アップロード済objectの保管ストレージ種別。”STANDARD”のみ。
PartNumberMarker integer パーツリストの開始パーツ番号
NextPartNumberMarker integer リストが切断される時、この要素にはリストの最後のパート(リクエストパラメタにある part-number-marker と同じ値)が指定されます。
MaxParts integer レスポンスで扱えるパーツの最大数
IsTruncated boolean パーツリストが途中で切断されているかを知るフラグ。MaxParts要素に書かれた最大値をパーツ番号が超えていたら、リストは切断されます。
Part string 特定のパーツに関係するコンテナ。レスポンスには0個以上のPart要素があります。
PartNumber integer パーツを識別するパーツ番号
LastModified datetime アップロード済パーツの最終更新日時
ETag string アップロード済パーツのETag
Size integer アップロード済パーツのデータサイズ
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>string</Bucket>
    <Encoding-Type>string</Encoding-Type>
    <Key>string</Key>
    <UploadId>string</UploadId>
    <Initiator>
        <ID>string</ID>
        <DisplayName>string</DisplayName>
    </Initiator>
    <Owner>
        <ID>string</ID>
        <DisplayName>string</DisplayName>
    </Owner>
    <StorageClass>string</StorageClass>
    <PartNumberMarker>integer</PartNumberMarker>
    <NextPartNumberMarker>integer</NextPartNumberMarker>
    <MaxParts>integer</MaxParts>
    <IsTruncated>Boolean</IsTruncated>
    <Part>
        <PartNumber>integer</PartNumber>
        <LastModified>Date</LastModified>
        <ETag>string</ETag>
        <Size>integer</Size>
    </Part>
</ListPartsResult>

レスポンスサンプル

HTTP/1.1 200 OK
Date: Tue, 01 Sep 2015 10:00:00 GMT
X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef
Server: Cleversafe/3.5.1.0
X-Clv-S3-Version: 2.4
x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 698
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>sample-bucket</Bucket>
    <Key>sample-object.txt</Key>
    <UploadId>12345678-9abc-def0-1234-56789abcdef0</UploadId>
    <Initiator>
        <ID>56789abc-def0-1234-5678-9abcdef01234</ID>
        <DisplayName>abc0001</DisplayName>
    </Initiator>
    <Owner>
        <ID>56789abc-def0-1234-5678-9abcdef01234</ID>
        <DisplayName>abc0001</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2015-09-01T10:00:00.000Z</LastModified>
        <ETag>"abcdef0123456789abcdef0123456789"</ETag>
        <Size>12345678</Size>
    </Part>
</ListPartsResult>
2021/06/21 2021/06/24