全部產品
Search
文件中心

Object Storage Service:list-multipart-uploads

更新時間:Apr 03, 2025

list-multipart-uploads用於列舉所有執行中的Multipart Upload事件。

注意事項

調用list-multipart-uploads命令列舉所有執行中的Multipart Upload事件指已經初始化但還未完成(Complete)或者還未中止(Abort)的Multipart Upload事件。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM PolicyBucket Policy授予操作許可權。

API

Action

說明

ListMultipartUploads

oss:ListMultipartUploads

列舉所有執行中的Multipart Upload事件,即已經初始化但尚未完成(Complete)或者尚未中止(Abort)的Multipart Upload事件。

命令格式

ossutil api list-multipart-uploads --bucket value [flags]
說明

list-multipart-uploads命令對應API介面ListMultipartUploads。關於API中的具體參數含義,請參見ListMultipartUploads

參數

類型

說明

--bucket

string

Bucket名稱。

--delimiter

string

對Object名字進行分組的字元。

--encoding-type

string

對返回的內容進行編碼並指定編碼的類型。

--max-uploads

int

返回的最大Upload個數。

--prefix

string

限定返回的Object Key必須以prefix作為首碼。

--upload-id-marker

string

與key-marker參數配合使用,用於指定返回結果的起始位置。

  • 如果未設定key-marker參數,則OSS會忽略upload-id-marker參數。

  • 如果設定了key-marker參數,查詢結果中包含:

    • 所有Object名稱的字典序大於key-marker參數值的Multipart Upload事件。

    • Object名稱等於key-marker參數值,但是UploadId比upload-id-marker參數值大的Multipart Upload事件。

--key-marker

string

與upload-id-marker參數配合使用,用於指定返回結果的起始位置。

  • 如果未設定upload-id-marker參數,查詢結果中包含所有Object名稱的字典序大於key-marker參數值的Multipart Upload事件。

  • 如果設定了upload-id-marker參數,查詢結果中包含:

    • 所有Object名稱的字典序大於key-marker參數值的Multipart Upload事件。

    • Object名稱等於key-marker參數值,但是UploadId比upload-id-marker參數值大的Multipart Upload事件。

說明

關於支援的全域命令列選項,請參見支援的全域命令列選項

使用樣本

  • 列舉目標儲存空間examplebucket所有正在執行的Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket
  • 列舉目標儲存空間examplebucket所有正在執行的Multipart Upload事件,以JSON格式顯示。

    ossutil api list-multipart-uploads --bucket examplebucket --output-format json
  • 列舉目標儲存空間examplebucket所有正在執行的Multipart Upload事件,以YAML格式顯示。

    ossutil api list-multipart-uploads --bucket examplebucket --output-format yaml
  • 列舉目標儲存空間examplebucket中指定首碼下dir下的Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket --prefix dir
  • 列舉目標儲存空間examplebucket中前100個Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket --max-uploads 100
  • 列舉目標儲存空間examplebucket中根目錄下的Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket --delimiter /
  • 列舉目標儲存空間examplebucket中從test.txt之後按字母排序返回的Multipart Upload事件。

    ossutil api list-multipart-uploads --bucket examplebucket --key-marker test.txt
  • 列舉目標儲存空間examplebucket中所有 Multipart Upload事件,並對對象名字進行URL編碼。

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