append-object用于以追加寫的方式上傳文件(Object)。
注意事項
阿里云賬號默認擁有設置和獲取Object的權限。如果您需要通過RAM用戶或者STS的方式進行設置和獲取,您必須擁有
oss:PutObject
和oss:GetObject
權限。具體操作,請參見為RAM用戶授權自定義的權限策略。通過append-object方式最后生成的Object大小不得超過5 GB。
append-object不支持指定CMK ID進行服務端KMS加密。
命令格式
ossutil api append-object --bucket value --key value --position value [flags]
參數 | 類型 | 說明 |
--body | string | 請求體。 |
--bucket | string | Bucket名稱。 |
--cache-control | string | 指定該Object的網頁緩存行為。 |
--content-disposition | string | 指定該Object被下載時的名稱。 |
--content-encoding | string | 指定該Object的內容編碼格式。 |
--content-md5 | string | 是一串由MD5算法生成的值,該請求頭用于檢查消息內容是否與發送時一致。 |
--expires | string | 過期時間。 |
--key | string | Object的完整路徑。 |
--metadata | stringArray | 指定設置的元數據,如需要自定義攜帶的元數據,需配置以x-oss-meta-*為前綴的參數。 |
--object-acl | string | 指定Object的訪問權限。 |
--position | string | 用于指定從何處進行追加。 |
--server-side-encryption | string | 指定服務器端加密方式。 |
--storage-class | string | 指定Object的存儲類型。 |
--tagging | string | 指定Object的對象標簽,可同時設置多個標簽,例如TagA=A和TagB=B。 |
append-object命令對應API接口AppendObject。關于API中的具體參數含義,請參見AppendObject。
關于支持的全局命令行選項,請參見支持的全局命令行選項。
使用示例
以字符串的形式追加exampleobject對象。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss"
以文件的形式追加exampleobject對象。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body file://appendFile
以字符串的形式追加exampleobject對象并攜帶自定義元數據。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --metadata user=aliyun --metadata email=ali***@aliyuncs.com
以字符串的形式追加exampleobject對象并指定object的標簽信息。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --tagging "TagA=A&TagB=B"
以字符串的形式追加exampleobject對象并指定object的訪問權限以及存儲類型。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --object-acl private --storage-class IA
以字符串的形式追加exampleobject對象并指定object服務器端加密方式。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --body "hi oss" --server-side-encryption AES256
以字符串的形式上傳文件并指定該Object被下載時網頁的緩存行為。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --cache-control no-cache
以字符串的形式上傳文件并指定該Object下載時的名稱。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"
以字符串的形式追加exampleobject對象并指定該Object的Content-MD5值。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-md5 ohhnqLBJFiKkPSBO1eNaUA==