All Products
Search

This Product

    Object Storage Service:append

    Document Center

    Object Storage Service:append

    Last Updated:Sep 24, 2026

    Appends content to the end of an appendable object.

    Usage notes

    • To perform an append upload, you must have the oss:GetObject and oss:PutObject permissions. For more information, see Grant a custom policy.

    • For more information about append uploads, see Append upload.

    • If the specified object does not exist, the command creates an appendable object. If the object exists but is not appendable, the command returns an error.

    Command syntax

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

    Parameter

    Type

    Description

    source

    string

    The data source. You can specify a local path, OSS path, or -.

    If you specify -, ossutil accepts input from the standard input.

    --storage-class

    string

    The storage class of the object. Valid values:

    • Standard: Standard

    • IA: Infrequent Access (IA)

    • Archive: Archive

    --acl

    string

    Specify the access control list (ACL) of the object. Valid values:

    • default: The ACL is inherited from the bucket

    • private: The ACL is private.

    • public-read: The ACL is public-read.

    • public-read-write: The ACL is public-read-write.

    --request-payer

    string

    The payer of the request. If pay-by-requester is enabled for the bucket, set this parameter to requester.

    --metadata

    strings

    The user metadata of the object in the format of key=value pairs.

    --tagging

    strings

    The object tags in the format of key=value pairs.

    --cache-control

    string

    Specifies the caching behavior in web browsers when the object is downloaded.

    --content-disposition

    string

    The display mode for the object.

    --content-encoding

    string

    The encoding method of the object.

    --content-type

    string

    The content type of the object.

    --encoding-type

    string

    The encoding method of the object name or file name. Valid values: url.

    --expires

    string

    The absolute expiration time of the cache in Greenwich Mean Time (GMT). For example, 2022-10-12T00:00:00.000Z.
    Note

    For more information, see Command-line options.

    Examples

    • Upload the 1.txt file from the local directory to the bucket, with the object ACL set to private and the tag=value tag added to the object. 

      ossutil append 1.txt oss://dst-bucket/append.txt --acl private --tagging tag=value

    • Append the content of 2.txt to the end of the append.txt object by using the standard input. 

      cat 2.txt | ossutil append - oss://dst-bucket/append.txt

    • Append the content of 3.txt in bucket src-bucket to the end of the append.txt object. 

      ossutil append oss://src-bucket/3.txt oss://dst-bucket/append.txt