すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListParts

    ドキュメントセンター

    Object Storage Service:ListParts

    最終更新日:Mar 27, 2025

    特定のアップロード ID を使用してアップロードされたすべてのパーツをリストします。

    使用上の注意

    • Object Storage Service (OSS) から返される結果は、フラグメント番号の昇順でリストされます。

    • ListParts リクエストへの応答のフラグメント番号と ETag を使用する代わりに、ローカルに記録されたデータを使用して、パーツリストを生成することをお勧めします。 特定のアップロード ID を使用してアップロードされたパーツは、誤って上書きされる可能性があります。 この場合、CompleteMultipartUpload 操作を呼び出す前に、不要なパーツを削除する必要がある場合があります。または、ネットワーク転送中のエラーが原因で、OSS が受信したパーツデータが期待どおりにならない場合があります。 各パーツに対応するフラグメント番号と ETag がローカルに記録されていない場合、期待どおりのパーツデータは、ListParts リクエストへの応答に見つかりません。 その結果、OSS にアップロードされたパーツデータと元のコンテンツの一貫性と整合性を検証できません。

    権限

    デフォルトでは、Alibaba Cloud アカウントは、アカウント内のリソースに対するすべての権限を持っています。一方、Alibaba Cloud アカウントに関連付けられた RAM ユーザーおよび RAM ロールは、最初は権限を持ちません。RAM ユーザーまたはロールを使用してリソースを管理するには、RAM ポリシーまたはバケットポリシーを使用して、必要な権限を付与する必要があります。

    API

    アクション

    説明

    ListParts

    oss:ListParts

    指定されたアップロード ID を使用してアップロードされたすべてのパーツをリストします。

    リクエスト構文

    Get  /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

    リクエストヘッダー

    ListParts リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。

    リクエストパラメーター

    パラメーター

    タイプ

    例

    説明

    uploadId

    文字列

    0004B999EF5A239BB9138C6227D6****

    マルチパートアップロードタスクの ID です。

    デフォルトでは、このパラメーターは空のままです。

    max-parts

    整数

    1000

    OSS が返すことができるパーツの最大数です。

    デフォルト値: 1000。

    最大値: 1000。

    part-number-marker

    整数

    100

    リストの開始位置です。 フラグメント番号がこのパラメーターの値よりも大きいすべてのパーツがリストされます。

    デフォルトでは、このパラメーターは空のままです。

    encoding-type

    文字列

    url

    レスポンスのオブジェクト名のエンコーディングタイプです。 オブジェクト名には、UTF-8 でエンコードされた文字を含めることができます。 ただし、XML 1.0 標準を使用して、ASCII 値が 0 から 10 までの文字など、特定のコントロール文字を解析することはできません。 このパラメーターを設定して、レスポンスのオブジェクト名をエンコードできます。

    デフォルトでは、このパラメーターは空のままです。

    有効な値: url。

    レスポンスヘッダー

    ListParts リクエストへのレスポンスのすべてのヘッダーは、共通レスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

    レスポンス要素

    要素

    タイプ

    例

    説明

    ListPartsResult

    コンテナー

    該当なし

    ListParts リクエストのレスポンスを格納するコンテナーです。

    子ノード: Bucket、Key、UploadId、PartNumberMarker、NextPartNumberMarker、MaxParts、IsTruncated、および Part

    親ノード: なし

    Bucket

    文字列

    multipart_upload

    バケットの名前です。

    親ノード: ListPartsResult

    EncodingType

    文字列

    url

    レスポンスのオブジェクト名のエンコーディングタイプです。 リクエストで encoding-type パラメーターが指定されている場合、レスポンスのオブジェクト名はエンコードされます。

    親ノード: ListPartsResult

    Key

    文字列

    multipart.data

    オブジェクトの名前です。

    親ノード: ListPartsResult

    UploadId

    文字列

    0004B999EF5A239BB9138C6227D69F95

    アップロードタスクの ID です。

    親ノード: ListPartsResult

    PartNumberMarker

    整数

    10

    リストの開始位置です。 フラグメント番号がこのパラメーターの値よりも大きいすべてのパーツがリストされます。

    親ノード: ListPartsResult

    NextPartNumberMarker

    整数

    5

    レスポンスにすべての必要な結果が含まれていない場合に、後続のリクエストの PartNumberMarker 値に使用される NextPartNumberMarker 値です。

    親ノード: ListPartsResult

    MaxParts

    整数

    1000

    レスポンスに含まれるパーツの最大数です。

    親ノード: ListPartsResult

    IsTruncated

    列挙文字列

    false

    レスポンスで返されたパーツのリストが切り詰められているかどうかを示します。 true の値は、レスポンスにすべての必要な結果が含まれていないことを示します。 false の値は、レスポンスにすべての必要な結果が含まれていることを示します。

    有効な値: true および false。

    親ノード: ListPartsResult

    Part

    コンテナー

    該当なし

    パーツに関する情報を格納するコンテナーです。

    子ノード: PartNumber、LastModified、ETag、および Size

    親ノード: ListPartsResult

    PartNumber

    整数

    1

    パーツを識別する番号です。

    親ノード: ListPartsResult.Part

    LastModified

    日付

    2012-02-23T07:01:34.000Z

    パーツがアップロードされた日時です。

    親ノード: ListPartsResult.Part

    ETag

    文字列

    3349DC700140D7F86A0784842780****

    アップロードされたパーツの ETag です。

    親ノード: ListPartsResult.Part

    Size

    整数

    6291456

    アップロードされたパーツのサイズです。

    親ノード: ListPartsResult.Part

    例

    リクエストの例

    Get  /multipart.data?uploadId=0004B999EF5A239BB9138C6227D6****  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS qn6q**************:77Dv****************

    成功レスポンスの例

    HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1221
Content-type: application/xml
x-oss-request-id: 106452c8-10ff-812d-736e-c865294afc1c
Date: Thu, 23 Feb 2012 07:13:28 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>multipart_upload</Bucket>
    <Key>multipart.data</Key>
    <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
    <NextPartNumberMarker>5</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2012-02-23T07:01:34.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2012-02-23T07:01:12.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>5</PartNumber>
        <LastModified>2012-02-23T07:02:03.000Z</LastModified>
        <ETag>"7265F4D211B56873A381D321F586****"</ETag>
        <Size>1024</Size>
    </Part>
</ListPartsResult>

    OSS SDK

    以下のプログラミング言語の OSS SDK を使用して、ListParts 操作を呼び出すことができます。

    ossutil

    ListParts 操作に対応する ossutil コマンドについては、「list-parts」をご参照ください。