このトピックでは、listpartコマンドを実行して、マルチパートアップロードタスクが不完全なオブジェクトのパーツを一覧表示する方法について説明します。
使用上の注意
パーツを一覧表示するには、
oss:ListParts権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 バージョンが1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。 詳細は、「ossutilコマンドリファレンス」をご参照ください。
マルチパートアップロードの詳細については、「マルチパートアップロード」をご参照ください。
コマンド構文
ossutil listpart oss://bucketname/objectname uploadid次の表に、上記のパラメーターを示します。
パラメーター | 説明 |
bucketname | リストする部品が保存されているバケットの名前。 |
オブジェクト名 | マルチパートアップロードタスクが不完全なオブジェクトの名前。 |
uploadid | マルチパートアップロードタスクを識別するアップロードID。 マルチパートアップロードタスクを開始すると、アップロードIDが返されます。 アップロードIDを使用して、マルチパートアップロードタスクのキャンセルやクエリなどのマルチパートアップロード操作を実行できます。 |
lsコマンドの -mオプションを使用して、マルチパートアップロードタスクが完了していないオブジェクト、マルチパートアップロードタスクが開始された時刻、アップロードIDなどの部品情報を照会できます。 詳細については、「ls」をご参照ください。
例
次のコマンドを実行して、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 secretを指定します。
たとえば、次のコマンドを実行して、マルチパートアップロードタスクが不完全でないtestobject.txtオブジェクトの部分を照会できます。 testobject.txtオブジェクトは、中国 (杭州) リージョンにあり、別のAlibaba Cloudアカウントが所有するtestbucketバケットにあります。
ossutil listpart oss://testbucket/testobject.txt 46C56B10E94A4ED6G8U9869F9409**** -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****共通オプションの詳細については、「共通オプション」をご参照ください。