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

Object Storage Service:ListMultipartUploads

最終更新日:Feb 23, 2024

進行中のすべてのマルチパートアップロードタスクを一覧表示します。 タスクが完了またはキャンセルされていません。

リクエストの構造

Get /? HTTP/1.1のアップロード
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
承認: 署名 

リクエストパラメーター

パラメーター

データ型

説明

区切り文字

String

オブジェクトを名前でグループ化するために使用される文字。 リクエストに Delimiter パラメーターを指定した場合、レスポンスに CommonPrefixes 要素が含まれます。 プレフィックスから次の区切り文字までの同じ文字列を名前に含むオブジェクトは、CommonPrefixes内の単一の結果要素としてグループ化されます。

max-uploads

Integer

現在のリクエストに対して返すことができるマルチパートアップロードタスクの最大数。 デフォルト値は 1000 です。 最大値は 1000 です。

キーマーカー

String

このパラメーターは、upload-id-markerパラメーターと一緒に使用して、次のリストの開始位置を指定します。

  • upload-id-markerパラメーターが設定されていない場合、Object Storage Service (OSS) は、オブジェクト名がキーマーカー値の後にアルファベット順になっているすべてのマルチパートアップロードタスクを返します。

  • upload-id-markerパラメーターが設定されている場合、応答には次のタスクが含まれます。

    • オブジェクト名がアルファベット順にキーマーカー値の後にアルファベット順に表示されるマルチパートアップロードタスク

    • オブジェクト名がkey-markerパラメーター値と同じで、アップロードidがupload-id-markerパラメーター値より大きいマルチパートアップロードタスク

プレフィックス

String

返されるオブジェクト名に含める必要があるプレフィックス。 リクエストでプレフィックスを指定すると、指定されたプレフィックスがレスポンスに含まれます。

説明

プレフィックスを使用して、ファイルシステム内のフォルダーを管理するのと同じ方法で、バケット内のオブジェクトをグループ化および管理できます。

upload-id-marker

String

リストが開始されるマルチパートアップロードタスクのアップロードID。 このパラメーターは、key-markerパラメーターと一緒に使用されます。

  • key-markerパラメーターが設定されていない場合、OSSはupload-id-markerパラメーターを無視します。

  • key-markerパラメーターが設定されている場合、クエリ結果は次のとおりです。

    • オブジェクト名がアルファベット順にキーマーカー値の後にアルファベット順に表示されるマルチパートアップロードタスク

    • オブジェクト名がkey-markerパラメーター値と同じで、アップロードidがupload-id-markerパラメーター値より大きいマルチパートアップロードタスク

encoding-type

String

レスポンス内のオブジェクト名のエンコードタイプ。 Delimiter、KeyMarker、Prefix、NextKeyMarker、およびKeyの値は、UTF-8でエンコードできます。 ただし、XML 1.0標準は、0から10のASCII (American standard Code for Information Interchange) 値を持つ文字などの制御文字を解析するためには使用できません。 encoding-typeパラメーターを設定して、Delimiter、KeyMarker、Prefix、NextKeyMarker、およびKeyの値をレスポンスでエンコードできます。

既定値 : null 。

レスポンス要素

要素

データ型

説明

ListMultipartUploadsResult

Container

ListMultipartUploadリクエストに対する応答を格納するコンテナー。

子ノード: Bucket、KeyMarker、UploadIdMarker、NextKeyMarker、NextUploadIdMarker、MaxUploads、Delimiter、Prefix、CommonPrefixes、IsTruncated、Upload

親ノード: なし

Bucket

String

バケットの名前です。

親ノード: ListMultipartUploadsResult

EncodingType

String

レスポンスでオブジェクト名をエンコードするために使用されるメソッド。 encoding-typeがリクエストに指定されている場合、Delimiter、KeyMarker、Prefix、NextKeyMarker、およびKeyなどの要素の値は、返される結果にエンコードされます。

親ノード: ListMultipartUploadsResult

KeyMarker

String

リストが開始されるマルチパートアップロードタスクに対応するオブジェクトの名前。

親ノード: ListMultipartUploadsResult

UploadIdMarker

String

リストが開始されるマルチパートアップロードタスクのアップロードID。

親ノード: ListMultipartUploadsResult

NextKeyMarker

String

残りの結果を返す次のリクエストに対するレスポンスのオブジェクト名マーカー。

親ノード: ListMultipartUploadsResult

NextUploadMarker

String

応答に必要な結果がすべて含まれていない場合、次の要求でUploadMarker値に使用されるNextUploadMarker値。

親ノード: ListMultipartUploadsResult

MaxUploads

Integer

OSSから返されるマルチパートアップロードタスクの最大数。

親ノード: ListMultipartUploadsResult

IsTruncated

Enumerated string

応答で返されるマルチパートアップロードタスクのリストが切り捨てられるかどうかを示します。 デフォルト値:false 有効な値:

  • true: 今回は結果の一部のみが返されます。

  • false: すべての結果が返されます。

親ノード: ListMultipartUploadsResult

アップロード

Container

マルチパートアップロードタスクに関する情報を格納するコンテナー。

子ノード: Key、UploadId、およびInitiated

親ノード: ListMultipartUploadsResult

キー

String

マルチパートアップロードタスクが開始されたオブジェクトの名前。

親ノード: アップロード

説明

OSSから返される結果は、オブジェクト名の昇順のアルファベット順に表示されます。 同じオブジェクトをアップロードするために開始された複数のマルチパートアップロードタスクは、アップロードIDの昇順でリストされます。

UploadId

String

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

親ノード: アップロード

開始済み

日付

マルチパートアップロードタスクが初期化された時刻。

親ノード: アップロード

リクエストの例

Get /? HTTP/1.1のアップロード
ホスト: oss-例。 oss-cn-hangzhou.aliyuncs.com
日付: 2月23日木曜日2012 06:14:27 GMT
承認: OSS qn6qrrqxo2oawuk53otfjbyc:JX75CtQqsmBBz + dcivn7kwBM **** 

レスポンスの例

HTTP/1.1 200
サーバー: AliyunOSS
接続: キープアライブ
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561c ****
日付: 2月23日木曜日2012 06:14:27 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>oss-example</Bucket>
    <KeyMarker></KeyMarker>
    <UploadIdMarker></UploadIdMarker>
    <NextKeyMarker>oss.avi</NextKeyMarker>
    <NextUploadIdMarker>0004B99B8E707874FC2D692FA5D77D3F</NextUploadIdMarker>
    <Delimiter></Delimiter>
    <Prefix></Prefix>
    <MaxUploads>1000</MaxUploads>
    <IsTruncated>false</IsTruncated>
    <アップロード>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF518A1FE585B0C9360DC4C8</UploadId>
        <開始> 2012-02-23T04:18:23.000Z</開始>
    </アップロード>
    <アップロード>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF5A239BB9138C6227D6 ****</UploadId>
        <開始> 2012-02-23T04:18:23.000Z</開始>
    </アップロード>
    <アップロード>
        <キー> oss.avi</キー>
        <UploadId>0004B99B8E707874FC2D692FA5D7 ****</UploadId>
        <開始> 2012-02-23T06:14:27.000Z</開始>
    </アップロード>
</ListMultipartUploadsResult> 

SDK

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