全部產品
Search
文件中心

Object Storage Service:append(追加上傳)

更新時間:Aug 01, 2024

append命令用於在已上傳的追加類型對象(Appendable Object)末尾直接追加內容。

注意事項

  • 要追加上傳,您必須具有oss:GetObjectoss:PutObject許可權。具體操作,請參見為RAM使用者授權自訂的權限原則

  • 關於追加上傳的更多資訊,請參見追加上傳

  • 如果對象不存在,則建立追加類型的對象;如果對象已存在,且不是追加類型的,則返回錯誤。

命令格式

ossutil append source oss://bucket/object [flags]

參數

類型

說明

source

string

表示資料來源,支援本地路徑、OSS資源地址和-

當為-時,表示從標準輸入讀入。

--acl

string

對象的存取權限。取值:

  • private:私人。

  • public-read:公用讀取。

  • public-read-write:公用讀寫。

  • default:繼承Bucket。

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

對象的儲存類型, 取值:

  • Standard:標準儲存。

  • IA:低頻儲存。

  • Archive:Archive Storage。

  • ColdArchive:冷Archive Storage。

  • DeepColdArchive:深度冷Archive Storage。

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