append-object - Object Storage Service

append-object用於以追加寫的方式上傳檔案（Object）。

注意事項

通過append-object方式最後產生的Object大小不得超過5 GB。
append-object不支援指定CMK ID進行服務端KMS加密。

許可權說明

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

API

Action

說明

AppendObject

oss:PutObject

以追加寫的方式上傳檔案（Object）。

oss:PutObjectTagging

以追加寫的方式上傳檔案（Object）時，如果通過x-oss-tagging指定Object的標籤，則需要此操作的許可權。

命令格式

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==