ListParts - API リファレンス| Alibaba Cloud ドキュメントセンター

ListParts コマンドを使用すると、正常にアップロードされた特定のアップロード ID のすべてのパートをリストできます。

リクエスト構文

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

リクエストパラメーター

名前	型	説明
uploadId	String	マルチパートアップロードイベントの ID。デフォルト値: なし
max-parts	Integer	OSS の応答に表示されるパートの最大数。デフォルト値: 1,000
part-number-marker	Integer	特定のリストの開始位置。パートは、そのパート番号がこのパラメーターの値より大きい場合にのみリストされます。デフォルト値: なし
encoding-type	String	返されるコンテンツのエンコーディングとエンコーディングのタイプを指定します。オブジェクトキーでは UTF-8 文字が使用されますが、XML 1.0 標準では、0 ～ 10 の ASCII 値を含む文字などの特定の制御文字の解析はサポートされていません。XML 1.0 標準でサポートされていない制御文字がオブジェクトキーに含まれている場合は、encoding-type を指定して返されるオブジェクトキーをエンコードできます。デフォルト値: なし

レスポンスの要素

名前	型	説明
ListPartsResult	Container	List Parts リクエストの結果の格納に使用されるコンテナー。サブノード: Bucket、Key、UploadId、PartNumberMarker、NextPartNumberMarker、MaxParts、IsTruncated、Part 親ノード: なし
Bucket	String	バケット名を指定します。親ノード: ListPartsResult
EncodingType	String	返される結果におけるエンコーディングのタイプを指定します。リクエストで encoding-type を指定した場合は、返される結果において Key がエンコードされます。親ノード: ListPartsResult
Key	String	オブジェクト名。親ノード: ListPartsResult
UploadId	String	アップロードイベントの ID。親ノード: ListPartsResult
PartNumberMarker	Integer	リスト結果内のパート番号の開始位置。親ノード: ListPartsResult
NextPartNumberMarker	Integer	今回返されなかった結果がある場合、応答リクエストには、次のリクエストにおける PartNumberMarker の値を示す NextPartNumberMarker 要素が含まれます。親ノード: ListPartsResult
MaxParts	Integer	返されたリクエストに表示されるパートの最大数。親ノード: ListPartsResult
IsTruncated	Enumerating strings	List Parts に対して返された結果リストが切り捨てられているかどうか。”true” は返されなかった結果があることを示し、”false” はすべての結果が返されたことを示します。有効な値: true と false 親ノード: ListPartsResult
Part	String	パート情報の格納に使用されるコンテナー。サブノード: PartNumber、LastModified、ETag、Size 親ノード: ListPartsResult
PartNumber	Integer	パート番号。親ノード: ListPartsResult.Part
LastModified	Date	パートのアップロード日時。親ノード: ListPartsResult.part
ETag	String	アップロードされたパートのコンテンツ内の ETag 値。親ノード: ListPartsResult.Part
Size	Integer	アップロードされたパートのサイズ。親ノード: ListPartsResult.Part

詳細分析

ListParts では、max-parts と part-number-marker の 2 つのリクエストパラメーターがサポートされています。
max-parts パラメーターの最大値は 1,000 で、デフォルト値も 1,000 です。
OSS から返される結果は、パート番号に基づいて昇順でリストされます。
ネットワーク伝送でエラーが発生する可能性があるため、List Parts の結果 (パート番号と ETag 値) を使用して Complete Multipart の最終パートリストを生成しないことをお勧めします。

例

リクエストの例:

Get  /multipart.data?uploadId=0004B999EF5A239BB9138C6227D69F95  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:4qOnUMc9UQWqkz8wDqD3lIsa9P8=

レスポンスの例:

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>0004B999EF5A239BB9138C6227D69F95</UploadId>
    <NextPartNumberMarker>5</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2012-02-23T07:01:34.000Z</LastModified>
        <ETag>&quot;3349DC700140D7F86A078484278075A9&quot;</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2012-02-23T07:01:12.000Z</LastModified>
        <ETag>&quot;3349DC700140D7F86A078484278075A9&quot;</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>5</PartNumber>
        <LastModified>2012-02-23T07:02:03.000Z</LastModified>
        <ETag>&quot;7265F4D211B56873A381D321F586E4A9&quot;</ETag>
        <Size>1024</Size>
    </Part>
</ListPartsResult>