initiate-multipart-upload用於通知OSS初始化一個Multipart Upload事件。
注意事項
調用介面會返回一個OSS伺服器建立的全域唯一的Upload ID,用於標識本次Multipart Upload事件。您可以根據這個ID來發起相關的操作,例如中止Multipart Upload、查詢Multipart Upload等。
初始化MultipartUpload請求,並不影響已存在的同名Object。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
InitiateMultipartUpload |
| 初始化分區上傳任務。 |
| 初始化分區上傳任務時,如果通過x-oss-tagging指定Object的標籤,則需要此操作的許可權。 | |
| 上傳Object時,如果Object的中繼資料套件含X-Oss-Server-Side-Encryption: KMS,則需要這兩個操作的許可權。 | |
|
命令格式
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。 |
initiate-multipart-upload命令對應API介面InitiateMultipartUpload。關於API中的具體參數含義,請參見InitiateMultipartUpload。
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
通知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"