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

Object Storage Service:進行中のマルチパートアップロードを一覧表示する

最終更新日:Jul 04, 2025

進行中のすべてのマルチパートアップロードタスクを一覧表示します。

使用方法

進行中のマルチパートアップロードタスクとは、初期化済みで、完了もキャンセルもされていないタスクのことです。

権限

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

API

アクション

定義

ListMultipartUploads

oss:ListMultipartUploads

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

コマンド構文

ossutil api list-multipart-uploads --bucket value [flags]
説明
  • list-multipart-uploads コマンドは、ListMultipartUploads 操作に対応しています。 ListMultipartUploads 操作のパラメーターの詳細については、「ListMultipartUploads」をご参照ください。

パラメーター

タイプ

説明

--bucket

string

バケットの名前。

--delimiter

string

オブジェクトを名前でグループ化するために使用する文字。

--encoding-type

string

レスポンス内のオブジェクト名のエンコーディングタイプ。

--max-uploads

int

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

--prefix

string

返されるオブジェクトの名前に含まれる必要があるプレフィックス。

--upload-id-marker

string

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

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

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

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

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

--key-marker

string

このパラメーターは、upload-id-marker パラメーターとともに使用して、返される結果の開始位置を指定します。

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

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

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

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

説明

サポートされているグローバルコマンドラインオプションの詳細については、「グローバルコマンドラインオプション」をご参照ください。

  • examplebucket という名前のバケット内の進行中のすべてのマルチパートアップロードタスクを一覧表示します。

    ossutil api list-multipart-uploads --bucket examplebucket
  • examplebucket という名前のバケット内の進行中のすべてのマルチパートアップロードタスクを一覧表示し、リスト結果を JSON 形式で表示します。

    ossutil api list-multipart-uploads --bucket examplebucket --output-format json
  • examplebucket という名前のバケット内の進行中のすべてのマルチパートアップロードタスクを一覧表示し、リスト結果を YAML 形式で表示します。

    ossutil api list-multipart-uploads --bucket examplebucket --output-format yaml
  • examplebucket という名前のバケット内の、名前に dir プレフィックスが含まれる進行中のすべてのマルチパートアップロードタスクを一覧表示します。

    ossutil api list-multipart-uploads --bucket examplebucket --prefix dir
  • examplebucket という名前のバケット内の最初の 100 件の進行中のマルチパートアップロードタスクを一覧表示します。

    ossutil api list-multipart-uploads --bucket examplebucket --max-uploads 100
  • examplebucket という名前のバケットのルートディレクトリにある進行中のすべてのマルチパートアップロードタスクを一覧表示します。

    ossutil api list-multipart-uploads --bucket examplebucket --delimiter /
  • examplebucket という名前のバケット内の、名前が test.txt よりもアルファベット順で後の進行中のすべてのマルチパートアップロードタスクを一覧表示します。

    ossutil api list-multipart-uploads --bucket examplebucket --key-marker test.txt
  • examplebucket という名前のバケット内の進行中のすべてのマルチパートアップロードタスクを一覧表示し、オブジェクト名を URL エンコードします。

    ossutil api list-multipart-uploads --bucket examplebucket --encoding-type url