全部產品
Search
文件中心

Object Storage Service:initiate-multipart-upload

更新時間:Apr 03, 2025

initiate-multipart-upload用於通知OSS初始化一個Multipart Upload事件。

注意事項

  • 調用介面會返回一個OSS伺服器建立的全域唯一的Upload ID,用於標識本次Multipart Upload事件。您可以根據這個ID來發起相關的操作,例如中止Multipart Upload、查詢Multipart Upload等。

  • 初始化MultipartUpload請求,並不影響已存在的同名Object。

許可權說明

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

API

Action

說明

InitiateMultipartUpload

oss:PutObject

初始化分區上傳任務。

oss:PutObjectTagging

初始化分區上傳任務時,如果通過x-oss-tagging指定Object的標籤,則需要此操作的許可權。

kms:GenerateDataKey

上傳Object時,如果Object的中繼資料套件含X-Oss-Server-Side-Encryption: KMS,則需要這兩個操作的許可權。

kms:Decrypt

命令格式

ossutil api initiate-multipart-upload --bucket value --key value [flags]

參數

類型

說明

--bucket

string

Bucket名稱。

--key

string

Object的完整路徑。

--encoding-type

string

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

--content-encoding

string

指定該Object被下載時的內容編碼格式。

--content-type

string

對象的內容類型。

--content-disposition

string

指定該Object被下載時的名稱。

--cache-control

string

指定該Object被下載時的網頁的緩衝行為。

--metadata

stringArray

指定對象的使用者中繼資料,使用key=value格式,如需要自訂攜帶的中繼資料,需配置以x-oss-meta-*為首碼的參數。

--server-side-data-encryption

string

指定Object的密碼編譯演算法。

--server-side-encryption

string

指定上傳該Object的每個part時使用的伺服器端加密方式。

--server-side-encryption-key-id

string

表示KMS託管的使用者主要金鑰。

--storage-class

string

指定Object的儲存類型。

--tagging

string

指定Object的標籤。

--expires

string

到期時間,單位為毫秒。

--forbid-overwrite

string

指定CompleteMultipartUpload操作時是否覆蓋同名Object。

說明

使用樣本

  • 通知OSS初始化一個Multipart Upload事件。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject
  • 通知OSS初始化一個Multipart Upload事件,以JSON格式顯示。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format json
  • 通知OSS初始化一個Multipart Upload事件,以YAML格式顯示。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format yaml
  • 通知OSS初始化一個Multipart Upload事件,攜帶自訂中繼資料。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com
  • 通知OSS初始化一個Multipart Upload事件,指定object的標籤資訊。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --tagging "TagA=A&TagB=B"
  • 通知OSS初始化一個Multipart Upload事件,指定object伺服器端加密方式。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac****
  • 通知OSS初始化一個Multipart Upload事件,並禁止覆蓋同名Object。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --forbid-overwrite true
  • 通知OSS初始化一個Multipart Upload事件,指定該Object被下載時網頁的緩衝行為。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --cache-control no-cach
  • 通知OSS初始化一個Multipart Upload事件,指定該Object被下載時的名稱。

    ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --content-disposition "attachment;filename=oss_download.jpg"