Object Storage Service:cp (upload files)

Parameter

Type

Description

source

string

Local file path. Supports relative paths, absolute paths, and -. When set to -, data is read from standard input.

dest

string

File path in the destination bucket. Example: oss://bucket[/prefix].

--acl

string

Access permissions for the object. Valid values:

• private: private.

• public-read: Public read.

• public-read-write: Public read and write.

• default: inherit from the bucket.

--bandwidth-limit

SizeSuffix

Limits network bandwidth to control data transfer rate. Minimum value is 1024 B/s. The default unit is B/s.

When setting this parameter, specify a unit as needed. Valid units include B (bytes), K (kilobytes), M (megabytes), and G (gigabytes). For example, 50 M sets the bandwidth limit to 50 MB/s.

--bigfile-threshold

SizeSuffix

Threshold (in bytes) to enable multipart upload, download, or copy for large files. Default value: 104857600.

--cache-control

string

Specifies caching behavior when the object is downloaded by a web browser.

--content-disposition

string

Specifies how the object is displayed.

--content-encoding

string

Declares the encoding method of the object.

--content-type

string

Content type of the object.

--copy-props

string

Determines which properties to copy from the source object. Valid values:

• none

• metadata

• default

--checkpoint-dir

string

• If no checkpoint directory path is specified, resumable upload is disabled.

• If a directory is specified, resumable upload is enabled, and checkpoint files are saved in the .ossutil_checkpoint subdirectory under the specified path.

-d, --dirs

string

List files and subdirectories in the current directory without recursively listing all files in subdirectories.

--encoding-type

string

Encoding method for input object names or file names. Valid value: url.

--end-with

string

Returns objects that come before or match the specified value in alphabetical order.

--exclude

stringArray

Exclusion rules for paths or file names.

--exclude-from

stringArray

Read exclusion rules from a rule file.

--expires

stringArray

Specifies the absolute expiration time for cached content.

--files-from

stringArray

Read a list of source file names from a file, ignoring empty lines and comment lines. Applies only to filtering scenarios.

--files-from-raw

stringArray

Read a list of source file names from a file. Applies only to filtering scenarios.

--filter

stringArray

Filtering rules for paths or file names.

--filter-from

stringArray

Read filtering rules from a rule file.

-f, --force

/

Force the operation without prompting for confirmation.

--include

stringArray

Inclusion rules for paths or file names.

--include-from

stringArray

Read inclusion rules from a rule file.

-j, --job

int

Number of concurrent tasks. Default value: 3.

--listObjects

/

Use the ListObjects API to list objects.

--max-size

SizeSuffix

Maximum file size to transfer. Default unit is bytes. You can also use suffixes: B|K|M|G|T|P. Note: 1K (KiB) = 1024B.

--metadata

strings

User-defined metadata for the object, in key=value format.

--metadata-directive

string

Specifies how to set metadata for the destination object. Valid values:

• COPY

• REPLACE

--metadata-exclude

stringArray

Exclusion rules for object metadata.

--metadata-filter

stringArray

Filtering rules for object metadata.

--metadata-filter-from

stringArray

Read object metadata filtering rules from a rule file.

--metadata-include

stringArray

Inclusion rules for object metadata.

--min-age

Duration

Upload only files modified before the specified time interval. Default unit is seconds. You can use suffixes such as h (hours). Example: 1h means 1 hour.

--max-age

Duration

Upload only files modified within the specified time interval. Default unit is seconds. You can use suffixes such as h (hours). Example: 1h means 1 hour.

--min-mtime

Time

Upload only files modified after the specified time. Time format: UTC, for example, 2006-01-02T15:04:05.

--max-mtime

Time

Upload only files modified before the specified time. Time format: UTC, for example, 2006-01-02T15:04:05.

--min-size

SizeSuffix

Minimum file size to transfer. Default unit is bytes. You can also use suffixes: B|K|M|G|T|P. Note: 1K (KiB) = 1024B.

--no-progress

/

Do not display the progress bar.

--page-size

int

Maximum number of objects listed per page during batch upload. Default value: 1000. Valid range: 1–1000.

--parallel

int

Number of concurrent tasks for internal operations on a single file.

--part-size

SizeSuffix

Part size for multipart upload. By default, ossutil calculates an appropriate part size based on the file size. Valid range: 100 KiB–5 GiB.

-r, --recursive

/

Perform the operation recursively. When this option is specified, the command operates on all matching objects in the bucket. Otherwise, it operates only on the object specified by the path.

--request-payer

string

Payment method for the request. Set this parameter if the bucket uses pay-by-requester mode. Valid value: requester.

--size-only

/

Upload only source files whose size differs from the destination files.

--storage-class

string

Storage class of the object. Valid values:

• Standard: Standard storage.

• IA: Infrequent access storage.

• Archive: Archive Storage.

• ColdArchive: Cold Archive storage.

• DeepColdArchive: Deep Cold Archive storage.

--tagging

strings

Tags for the object, in key=value format.

--tagging-directive

string

Specifies how to set tags for the destination object. Valid values:

• COPY

• REPLACE

-u, --update

/

Skip files that already exist at the destination and have a newer modification time than the source files.

--ignore-existing

/

Skip files that already exist at the destination.