すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListParts

    ドキュメントセンター

    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の値は、応答に必要な結果がすべて含まれていることを示します。

    有効な値は true と false です。

    親ノード: 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操作を呼び出すことができます。