すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ListParts

最終更新日:Feb 23, 2024

特定のアップロードIDを使用してアップロードされるすべての部品を一覧表示します。

使用上の注意

  • Object Storage Service (OSS) から返された結果は、部品番号の昇順で表示されます。

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

リクエスト構文

Get /ObjectName?uploadId=UploadId HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
承認: 署名 

リクエストヘッダー

このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

リクエストパラメーター

パラメーター

データ型

説明

uploadId

String

0004B999EF5A239BB9138C6227D6 ****

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

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

max-parts

Integer

1000

OSSが返すことができる部品の最大数。

デフォルト値: 1000

最大値: 1000

part-number-marker

Integer

100

リストの開始位置。 部品番号がこのパラメータの値より大きいすべての部品が一覧表示されます。

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

encoding-type

String

url

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

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

有効値: url

レスポンスヘッダー

このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンス要素

要素

データ型

説明

ListPartsResult

Container

N/A

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

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

親ノード: なし

Bucket

String

multipart_upload

バケットの名前です。

親ノード: ListPartsResult

EncodingType

String

url

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

親ノード: ListPartsResult

キー

String

multipart.data

オブジェクト名

親ノード: ListPartsResult

UploadId

String

0004B999EF5A239BB9138C6227D69F95

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

親ノード: ListPartsResult

PartNumberMarker

Integer

10

リストの開始位置。 部品番号がこのパラメータの値より大きいすべての部品が一覧表示されます。

親ノード: ListPartsResult

NextPartNumberMarker

Integer

5

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

親ノード: ListPartsResult

MaxParts

Integer

1000

レスポンス内のパーツの最大数。

親ノード: ListPartsResult

IsTruncated

Enumerated string

false

応答で返された部品のリストが切り捨てられているかどうかを示します。 値がtrueの場合、応答に必要な結果がすべて含まれていないことを示します。 falseの値は、応答に必要な結果がすべて含まれていることを示します。

有効な値は truefalse です。

親ノード: ListPartsResult

パート

Container

N/A

部品に関する情報を格納するコンテナー。

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

親ノード: ListPartsResult

PartNumber

Integer

1

部品を識別する番号。

親ノード: ListPartsResult.Part

LastModified

日付

2012-02-23T07:01:34.000Z

パーツがアップロードされた時刻。

親ノード: ListPartsResult.Part

ETag

String

3349DC700140D7F86A0784842780 ****

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

親ノード: ListPartsResult.Part

サイズ

Integer

6291456

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

親ノード: ListPartsResult.Part

リクエストの例

Get /multipart.data?uploadId=0004B999EF5A239BB9138C6227D6 **** HTTP/1.1
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
日付: 2月23日木曜日07:13:28 GMT 2012
権限付与: OSS qn6qrrqxo2oawuk53otf ****:4qOnUMc9UQWqkz8wDqD3lIsa **** 

通常のレスポンス例

HTTP/1.1 200
サーバー: AliyunOSS
接続: キープアライブ
Content-length: 1221
Content-type: application/xml
x-oss-request-id: 106452c8-10ff-812d-736e-c865294afc1c
日付: 2月23日木曜日07:13:28 GMT 2012

<?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>
    <パート>
        <PartNumber>1</PartNumber>
        <LastModified>2012-02-23T07:01:34.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780 ****"</ETag>
        <サイズ> 6291456</サイズ>
    </パート>
    <パート>
        <PartNumber>2</PartNumber>
        <LastModified>2012-02-23T07:01:12.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780 ****"</ETag>
        <サイズ> 6291456</サイズ>
    </パート>
    <パート>
        <PartNumber>5</PartNumber>
        <LastModified>2012-02-23T07:02:03.000Z</LastModified>
        <ETag>"7265F4D211B56873A381D321F586 ****"</ETag>
        <サイズ> 1024</サイズ>
    </パート>
</ListPartsResult> 

OSS SDK

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