append命令用於在已上傳的追加類型對象(Appendable Object)末尾直接追加內容。
注意事項
要追加上傳,您必須具有
oss:GetObject
和oss:PutObject
許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。關於追加上傳的更多資訊,請參見追加上傳。
如果對象不存在,則建立追加類型的對象;如果對象已存在,且不是追加類型的,則返回錯誤。
命令格式
ossutil append source oss://bucket/object [flags]
參數 | 類型 | 說明 |
source | string | 表示資料來源,支援本地路徑、OSS資源地址和 當為 |
--acl | string | 對象的存取權限。取值:
|
--cache-control | string | 指定該對象被下載時網頁的緩衝行為。 |
--content-disposition | string | 指定對象的展示形式。 |
--content-encoding | string | 聲明對象的編碼方式。 |
--content-type | string | 對象的內容類型。 |
--encoding-type | string | 輸入的對象名或檔案名稱的編碼方式。取值:url。 |
--expires | string | 指定緩衝內容的絕對到期時間。 |
--metadata | strings | 指定對象的使用者中繼資料,使用key=value格式。 |
--request-payer | string | 請求的支付方式,如果為要求者付費模式,請設定該值。取值:requester。 |
--storage-class | string | 對象的儲存類型, 取值:
|
--tagging | strings | 指定對象的標籤,使用key=value格式。 |
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
首次上傳本地檔案1.txt,並指定檔案讀寫權限為私人,標籤為tag=value。
ossutil append 1.txt oss://dst-bucket/append.txt --acl private --tagging tag=value
採用標準輸入方式,在append.txt檔案末尾追加2.txt。
cat 2.txt | ossutil append - oss://dst-bucket/append.txt
把儲存空間src-bucket裡的3.txt追加到append.txt檔案末尾。
ossutil append oss://src-bucket/3.txt oss://dst-bucket/append.txt