すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListMultipartUploads

    ドキュメントセンター

    Object Storage Service:ListMultipartUploads

    最終更新日:Jun 03, 2025

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

    権限

    デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。

    API

    アクション

    定義

    ListMultipartUploads

    oss:ListMultipartUploads

    初期化済みで、まだ完了も中止もされていない、すべての進行中のマルチパートアップロードイベントをリストします。

    リクエスト構文

    Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

    リクエストパラメーター

    パラメーター

    タイプ

    説明

    delimiter

    文字列

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

    max-uploads

    整数

    現在のリクエストに対して返されるマルチパートアップロードタスクの最大数。デフォルト値：1000。最大値：1000。

    key-marker

    文字列

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

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

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

      • オブジェクト名が key-marker 値よりアルファベット順で後のマルチパートアップロードタスク

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

    prefix

    文字列

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

    説明

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

    upload-id-marker

    文字列

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

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

    • key-marker パラメーターが設定されている場合、クエリ結果には次のものが含まれます。

      • オブジェクト名が key-marker 値よりアルファベット順で後のマルチパートアップロードタスク

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

    encoding-type

    文字列

    レスポンス内のオブジェクト名のエンコーディングタイプ。Delimiter、KeyMarker、Prefix、NextKeyMarker、および Key の値は UTF-8 でエンコードできます。ただし、XML 1.0 標準では、ASCII 値が 0 ～ 10 の文字などの制御文字を解析することはできません。encoding-type パラメーターを設定して、レスポンス内の Delimiter、KeyMarker、Prefix、NextKeyMarker、および Key の値をエンコードできます。

    デフォルト値：null

    レスポンス要素

    要素

    タイプ

    説明

    ListMultipartUploadsResult

    コンテナー

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

    子ノード：Bucket、KeyMarker、UploadIdMarker、NextKeyMarker、NextUploadIdMarker、MaxUploads、Delimiter、Prefix、CommonPrefixes、IsTruncated、および Upload

    親ノード：なし

    Bucket

    文字列

    バケットの名前。

    親ノード：ListMultipartUploadsResult

    EncodingType

    文字列

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

    親ノード：ListMultipartUploadsResult

    KeyMarker

    文字列

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

    親ノード：ListMultipartUploadsResult

    UploadIdMarker

    文字列

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

    親ノード：ListMultipartUploadsResult

    NextKeyMarker

    文字列

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

    親ノード：ListMultipartUploadsResult

    NextUploadMarker

    文字列

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

    親ノード：ListMultipartUploadsResult

    MaxUploads

    整数

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

    親ノード：ListMultipartUploadsResult

    IsTruncated

    列挙文字列

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

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

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

    親ノード：ListMultipartUploadsResult

    Upload

    コンテナー

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

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

    親ノード：ListMultipartUploadsResult

    Key

    文字列

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

    親ノード：Upload

    説明

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

    UploadId

    文字列

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

    親ノード：Upload

    Initiated

    日付

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

    親ノード：Upload

    例

    リクエストの例

    Get /?uploads  HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    レスポンスの例

    HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561c****
Date: Thu, 23 Feb 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>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF518A1FE585B0C9360DC4C8</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>oss.avi</Key>
        <UploadId>0004B99B8E707874FC2D692FA5D7****</UploadId>
        <Initiated>2012-02-23T06:14:27.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>

    OSS SDK

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

    ossutil

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