initiate-multipart-upload用于通知OSS初始化一個Multipart Upload事件。
注意事項
阿里云賬號默認擁有通知OSS初始化一個Multipart Upload事件的權限。如果您需要通過RAM用戶或者STS的方式進行通知,您必須擁有
oss:PutObject
權限。具體操作,請參見為RAM用戶授權自定義的權限策略。調用接口會返回一個OSS服務器創建的全局唯一的Upload ID,用于標識本次Multipart Upload事件。您可以根據這個ID來發起相關的操作,例如中止Multipart Upload、查詢Multipart Upload等。
初始化MultipartUpload請求,并不影響已存在的同名Object。
命令格式
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"