このトピックでは、listpart コマンドを実行して、マルチパートアップロードタスクが未完了のオブジェクトのパートを一覧表示する方法について説明します。
使用上の注意
パートを一覧表示するには、
oss:ListParts権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。ossutil 1.6.16 以降では、コマンドラインでバイナリ名として ossutil を直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16 より前のバージョンの ossutil の場合は、オペレーティングシステムに基づいてバイナリ名をリフレッシュする必要があります。 詳細については、「ossutil コマンドリファレンス」をご参照ください。
マルチパートアップロードの詳細については、「マルチパートアップロード」をご参照ください。
コマンド構文
ossutil listpart oss://bucketname/objectname uploadid次の表に、上記のパラメーターについて説明します。
パラメーター | 説明 |
bucketname | 一覧表示するパートが格納されているバケットの名前。 |
objectname | マルチパートアップロードタスクが未完了のオブジェクトの名前。 |
uploadid | マルチパートアップロードタスクを識別するアップロード ID。 アップロード ID は、マルチパートアップロードタスクを開始するときに返されます。 アップロード ID を使用して、マルチパートアップロードタスクのキャンセルやクエリなど、マルチパートアップロード操作を実行できます。 |
-mls コマンドで ls オプションを使用すると、マルチパートアップロードタスクが完了していないオブジェクト、マルチパートアップロードタスクが開始された時刻、アップロード ID など、パート情報をクエリできます。 詳細については、「」をご参照ください。
例
次のコマンドを実行して、examplebucket バケット内のマルチパートアップロードタスクが未完了の exampleobject.txt オブジェクトのパートを一覧表示できます。
ossutil listpart oss://examplebucket/exampleobject.txt 89A46B10E94A4ED5A7E9869F9409****次の出力例は、パート数、ETag、パートサイズなどのパート情報の例を示しています。
PartNumber Etag Size(Byte) LastModifyTime
2 "BD106FED29B349A635BE289746DB****" 4443891 2021-07-21 09:01:33
3 "25DA5C7BB933DBD732B6C11111EB****" 4443891 2021-07-21 09:01:31
4 "AFDA91A8D4F476BAC972306873A3****" 4443891 2021-07-21 09:01:31
11 "2FFEE8D5049AB059D7EC801927BB****" 4443891 2021-07-21 09:01:32
total part count:4 total part size(MB):16.95
0.101978(s) elapsed共通オプション
ossutil を使用して別のリージョンにあるバケットに切り替える場合は、-e オプションを追加して、バケットが配置されているリージョンのエンドポイントを指定します。 ossutil を使用して別の Alibaba Cloud アカウントに属するバケットに切り替える場合は、-i オプションを追加して、指定したアカウントの AccessKey ID を指定し、-k オプションを追加して、指定したアカウントの AccessKey シークレットを指定します。
たとえば、次のコマンドを実行して、マルチパートアップロードタスクが未完了の testobject.txt オブジェクトのパートをクエリできます。 testobject.txt オブジェクトは、中国 (杭州) リージョンにあり、別の Alibaba Cloud アカウントが所有する testbucket バケットにあります。
ossutil listpart oss://testbucket/testobject.txt 46C56B10E94A4ED6G8U9869F9409**** -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret共通オプションの詳細については、「共通オプション」をご参照ください。