listpart命令用於列舉未完成分區上傳的檔案(Object)包含的片段(Part)資訊。
注意事項
要列舉片段,您必須具有
oss:ListParts
許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。從ossutil 1.6.16版本開始,命令列中Binary名稱支援直接使用ossutil,您無需根據系統重新整理Binary名稱。如果您的ossutil版本低於1.6.16,則需要根據系統重新整理Binary名稱。更多資訊,請參見命令列工具ossutil命令參考。
關於分區上傳的更多資訊,請參見分區上傳。
命令格式
ossutil listpart oss://bucketname/objectname uploadid
參數說明如下:
參數 | 說明 |
bucketname | 目標Bucket名稱。 |
objectname | 未完成分區上傳操作的Object名稱。 |
uploadid | 初始化Multipart Upload事件時返回的OSS伺服器建立的全域唯一的Upload ID,用於標識本次Multipart Upload事件。您可以通過Upload ID進行Multipart Upload的中止或查詢操作等。 |
您可以結合ls命令中的-m
選項擷取未完成分區上傳的Object名稱、初始化分區上傳的時間以及Upload ID資訊等。詳情請參見ls命令。
使用樣本
以下樣本用於列舉目標儲存空間examplebucket下未完成分區上傳的exampleobject.txt檔案的片段資訊:
ossutil listpart oss://examplebucket/exampleobject.txt 89A46B10E94A4ED5A7E9869F9409****
以下返回結果表明已成功擷取exampleobject.txt檔案的片段數量、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切換至另一個地區的Bucket時,可以通過-e選項指定該Bucket所屬的Endpoint。當您需要通過命令列工具ossutil切換至另一個阿里雲帳號下的Bucket時,可以通過-i選項指定該帳號的AccessKey ID,並通過-k選項指定該帳號的AccessKey Secret。
例如您需要擷取另一個阿里雲帳號下,華東1(杭州)名為testbucket的Bucket下的testobject.txt檔案所有未完成的Multipart任務產生的片段,命令如下:
ossutil listpart oss://testbucket/testobject.txt 46C56B10E94A4ED6G8U9869F9409**** -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****
關於此命令的其他通用選項的更多資訊,請參見通用選項。