全部產品
Search
文件中心

Object Storage Service:appendfromfile(追加上傳)

更新時間:Jul 31, 2024

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

注意事項

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

  • 從ossutil 1.6.16版本開始,命令列中Binary名稱支援直接使用ossutil,您無需根據系統重新整理Binary名稱。如果您的ossutil版本低於1.6.16,則需要根據系統重新整理Binary名稱。更多資訊,請參見命令列工具ossutil命令參考

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

命令格式

ossutil appendfromfile localfilename oss://bucketname/objectname
[--meta <value>]

參數說明如下:

選項

說明

localfilename

本地檔案完整路徑。

bucketname

目標Bucket名稱。

objectname

目標Object名稱。追加上傳時可直接將本地檔案名稱保留為Object名稱,也可以自訂上傳至Bucket後的Object名稱。

--meta

設定Object的meta資訊。僅支援在首次追加上傳時附加此選項,例如--meta "x-oss-object-acl:private"

Object的meta資訊配置完成後,您可以通過set-meta(管理檔案中繼資料)命令修改Object的meta資訊。

使用樣本

將本地根目錄下的檔案exampleobject.txt首次追加上傳至目標儲存空間examplebucket,然後直接在exampleobject.txt檔案末尾多次追加內容。

  1. 上傳檔案exampleobject.txt,並指定檔案讀寫權限為私人。

    ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt --meta "x-oss-object-acl:private"

    以下輸出結果表明exampleobject.txt已追加上傳至目標Bucket,此時檔案大小為5 Byte。

    total append 5(100.00%) byte,speed is 0.00(KB/s)
    local file size is 5,the object new size is 5,average speed is 0.04(KB/s)
  2. 在exampleobject.txt檔案末尾追加檔案dest.txt的內容。

    如果需要在exampleobject.txt檔案末尾多次追加內容,請相應替換如下樣本中的待追加上傳檔案dest.txt。

    ossutil appendfromfile dest.txt oss://examplebucket/exampleobject.txt

    以下輸出結果已在exampleobject.txt檔案後追加了內容,此時檔案大小為150 Byte。

    total append 150(100.00%) byte,speed is 0.00(KB/s)
    local file size is 150,the object new size is 150,average speed is 1.19(KB/s)

通用選項

當您需要通過命令列工具ossutil切換至另一個地區的Bucket時,可以通過-e選項指定該Bucket所屬的Endpoint。當您需要通過命令列工具ossutil切換至另一個阿里雲帳號下的Bucket時,可以通過-i選項指定該帳號的AccessKey ID,並通過-k選項指定該帳號的AccessKey Secret。

例如,您需要向另一個阿里雲帳號下,華東2(上海)下名為examplebucket的儲存空間追加上傳exampleobject.txt檔案,樣本如下:

ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt -e shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

關於此命令的其他通用選項的更多資訊,請參見通用選項