appendfromfile命令用於在已上傳的追加類型檔案(Appendable Object)末尾直接追加內容。
注意事項
要追加上傳,您必須具有
oss:GetObject
和oss: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資訊。僅支援在首次追加上傳時附加此選項,例如 |
使用樣本
將本地根目錄下的檔案exampleobject.txt首次追加上傳至目標儲存空間examplebucket,然後直接在exampleobject.txt檔案末尾多次追加內容。
上傳檔案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)
在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****
關於此命令的其他通用選項的更多資訊,請參見通用選項。