The appendfromfile command is used to upload local file content to an appendable object in OSS.

  • The commands described in this topic apply to Linux. To use the commands in other systems, replace ./ossutil in the command with the actual executable program name. For example, you can use the help command in 32-bit Windows systems by running ossutil32.exe help.
  • For more information about append upload, see Append upload.

Command syntax

 ./ossutil appendfromfile local_file_name oss://bucket/object [--meta=meta-value] [--payer requester] 
If the appendable object does not exist, you can use the --meta option to configure the object metadata, such as --meta "X-Oss-Meta-Author:test". The --meta option cannot be used to append content to an object that already exists.
  • You must specify the name for objects uploaded using append upload.
  • You can only append content to objects created using append upload.
  • You can use the set-meta command to modify the metadata of an object.


Use append Upload to upload an object:
./ossutil appendfromfile /file/test.txt oss://bucket1/test.txt 
total append 64(100.00%) byte,speed is 0.00(KB/s)
local file size is 64,the object new size is 64,average speed is 0.34(KB/s)

Common options

The following table describes the options you can add to the appendfromfile command.
Option Description 
--meta Configures the metadata of a specified object. The --meta option cannot be used to append content to an object that already exists.
--maxupspeed Specifies the maximum upload speed. Unit: KBit/s. Default value: 0 (unlimited).
--encoding-type Specifies the method used to encode the object name. If this option is specified, this value must be url. If this option is not specified, the object name is not encoded. Bucket names cannot be URL-encoded.
--loglevel Specifies the log level. The default value is null, indicating that no log files are generated. Valid values:
  • info: generates prompt logs.
  • debug: generates detailed logs that contain corresponding HTTP request and response information.
--payer Specifies the payer of the request. To enable pay-by-requester, set this option to requester.
--proxy-host Specifies the URL of the proxy server. HTTP, HTTPS, and SOCKS5 proxies are supported. An example of the URL is http://120.79. **.**:3128 or socks5://120.79. **. **:1080.
--proxy-user Specifies the username for the proxy server. The default value is null.
--proxy-pwd Specifies the password for the proxy server. The default value is null.
Note For more information about common options, see View all supported options.