Object Storage Service:cp (upload file)

Parameter

Type

Description

source

string

The local file path. You can use a relative path, an absolute path, or -. If you use -, ossutil reads data from standard input.

dest

string

The destination object path, in the format oss://bucket[/prefix].

--acl

string

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

• private

• public-read

• public-read-write

• default: The object inherits the bucket's ACL.

--bandwidth-limit

SizeSuffix

The data transfer rate limit. The minimum value is 1024 B/s. The unit is B/s by default.

You can specify a unit for the bandwidth value, such as B (byte), K (kilobyte), M (megabyte), or G (gigabyte). For example, 50M specifies a bandwidth limit of 50 MB/s.

--bigfile-threshold

SizeSuffix

The file size threshold to trigger a multipart upload, download, or copy. The default value is 104857600 bytes (100 MiB).

--cache-control

string

Specifies how clients, such as browsers, should cache the object.

--content-disposition

string

Specifies whether the object is displayed inline or downloaded as an attachment.

--content-encoding

string

Specifies the content encoding of the object.

--content-type

string

The content type of the object.

--copy-props

string

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

• none

• metadata

• default

--checkpoint-dir

string

• If this option is omitted, resumable upload is disabled.

• Enables resumable upload. When this option is specified, checkpoint files are saved to the .ossutil_checkpoint subdirectory of the specified directory.

-d, --dirs

string

When copying a directory, this option copies only the files at the top level of the source directory and ignores its subdirectories.

--encoding-type

string

The encoding type of the input object name or file name. The only valid value is url.

--end-with

string

Includes only files whose names end with the specified string.

--exclude

stringArray

The exclusion rules for paths or file names.

--exclude-from

stringArray

Reads exclusion rules from a rule file.

--expires

stringArray

Specifies the absolute expiration time for the cached content.

--files-from

stringArray

Reads a list of source file names from a file, ignoring empty lines or commented lines. This option is for filtering purposes only.

--files-from-raw

stringArray

Reads a list of source file names from a file. This option is for filtering purposes only.

--filter

stringArray

The filtering rules for paths or file names.

--filter-from

stringArray

Reads filtering rules from a rule file.

-f, --force

/

Forces the operation without a confirmation prompt.

--include

stringArray

The inclusion rules for paths or file names.

--include-from

stringArray

Reads inclusion rules from a rule file.

-j, --job

int

The number of concurrent upload tasks. Default value: 3.

--listObjects

/

Uses the ListObjects API operation to list objects.

--max-size

SizeSuffix

The maximum size of a file to transfer. The value is in bytes by default, but you can use a suffix, such as B, K, M, G, T, or P. 1 K (KiB) = 1024 B.

--metadata

strings

Specifies the user metadata of the object in key=value format.

--metadata-directive

string

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

• COPY

• REPLACE

--metadata-exclude

stringArray

The exclusion rules for object metadata.

--metadata-filter

stringArray

The filtering rules for object metadata.

--metadata-filter-from

stringArray

Reads object metadata filtering rules from a rule file.

--metadata-include

stringArray

The inclusion rules for object metadata.

--min-age

Duration

Uploads only files modified at least the specified time interval ago. The default unit is seconds. You can use a unit suffix, such as 1h for 1 hour.

--max-age

Duration

Uploads only files modified within the specified time interval. The default unit is seconds. You can use a unit suffix, such as 1h for 1 hour.

--min-mtime

Time

Uploads only files modified after the specified time. The time must be in UTC format. Example: 2006-01-02T15:04:05.

--max-mtime

Time

Uploads only files modified before the specified time. The time must be in UTC format. Example: 2006-01-02T15:04:05.

--min-size

SizeSuffix

The minimum size of a file to transfer. The value is in bytes by default, but you can use a suffix, such as B, K, M, G, T, or P. 1 K (KiB) = 1024 B.

--no-progress

/

Disables the progress bar.

--page-size

int

The maximum number of objects to list in each paged request during a batch upload. The value must be in the range of 1 to 1,000. Default value: 1000.

--parallel

int

For a single large file, this sets the number of parts to upload concurrently.

--part-size

SizeSuffix

The size of each part in a multipart upload. By default, ossutil calculates an optimal part size based on the file size. The value must be in the range of 100 KiB to 5 GiB.

-r, --recursive

/

When uploading a directory, you must specify this option to recursively upload all of its files and subdirectories.

--request-payer

string

Specifies who pays for the request. Set this to requester if the destination bucket has Requester Pays mode enabled.

--size-only

/

Uploads only source files that have a different size than the destination files.

--storage-class

string

The storage class of the object. Valid values:

• Standard

• IA

• Archive

• Cold Archive

• Deep Cold Archive

--tagging

strings

Specifies tags for the object in key=value format. You can specify this option multiple times to add multiple tags.

--tagging-directive

string

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

• COPY

• REPLACE

-u, --update

/

Uploads a file only if the source file is newer than the destination file or if the destination file does not exist.

--ignore-existing

/

Skips destination files that already exist.