全部產品
Search
文件中心

Object Storage Service:listpart(列舉片段)

更新時間:Jul 31, 2024

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****

關於此命令的其他通用選項的更多資訊,請參見通用選項