Object Storage Service:set-props (Set object properties)

Parameter

Type

Description

--acl

string

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

• private: private.

• public-read: public-read.

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

• default: inherits from the bucket.

--bigfile-threshold

int

The threshold to enable multipart upload, download, or copy for large files. The default value is 104857600 bytes.

--cache-control

string

Specifies the web page caching behavior when the object is downloaded.

--content-disposition

string

Specifies how the object is displayed.

--content-encoding

string

Specifies the encoding format of the object.

--content-type

string

The content type of the object.

-d, --dirs

/

Returns the files and subdirectories in the current directory. It does not recursively display all files in all subdirectories.

--encoding-type

string

The encoding type of the input object name or file name. Valid value: url.

--end-with

string

Sorts objects alphabetically and returns objects that are before or at the specified value.

--exclude

stringArray

The rules to exclude paths or file names.

--exclude-from

stringArray

Reads exclusion rules from a rule file.

--expires

string

Specifies the absolute expiration time for the cached content.

--files-from

stringArray

Reads a list of source file names from a file. Empty lines or commented lines are ignored.

--files-from-raw

stringArray

Reads a list of source file names from a file.

--filter

stringArray

The rules to filter 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 rules to include paths or file names.

--include-from

stringArray

Reads inclusion rules from a rule file.

-j, --job

int

The number of concurrent tasks. The default value is 3.

--list-objects

/

Uses the ListObjects API operation to list objects.

--max-size

SizeSuffix

The maximum size of a file to transfer. The default unit is byte. You can use a suffix: B, K, M, G, T, or P. 1 K (KiB) = 1024 B.

--metadata

strings

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

Example: --metadata test=value,test1=value1.

--metadata-directive

string

The instruction to modify metadata. Valid values:

• replace: Retains only the metadata specified in the command line options.

• update: Takes the union of the metadata in the command line and the metadata of the object.

• purge: Clears all metadata.

• delete: Deletes the metadata specified in the command line options and retains the rest.

--metadata-exclude

stringArray

The rules to exclude object metadata.

--metadata-filter

stringArray

The rules to filter object metadata.

--metadata-filter-from

stringArray

Reads object metadata filtering rules from a rule file.

--metadata-include

stringArray

The rules to include object metadata.

--min-age

Duration

Sets properties only for files modified before the specified time interval. The default unit is second. You can use a unit suffix, such as 1h for 1 hour.

--max-age

Duration

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

--min-mtime

Time

Sets properties only for files modified after the specified time. The time must be in UTC format. For example, 2006-01-02T15:04:05.

--max-mtime

Time

Sets properties only for files modified before the specified time. The time must be in UTC format. For example, 2006-01-02T15:04:05.

--min-size

SizeSuffix

The minimum size of a file to transfer. The default unit is byte. You can use a suffix: B, K, M, G, T, or P. 1 K (KiB) = 1024 B.

--no-progress

/

Does not display the progress bar.

--page-size

int

The maximum number of objects to list on each page during batch processing. The default value is 1000. The value can range from 1 to 1000.

--parallel

int

The number of concurrent tasks for operations on a single file.

--part-size

SizeSuffix

The part size. By default, ossutil calculates an appropriate part size based on the file size. The value must be between 100 KiB and 5 GiB.

-r, --recursive

/

Performs the operation recursively. When you specify this option, the command is applied to all matching objects in the bucket. Otherwise, the command is applied only to the object specified by the path.

--request-payer

string

The payment method for the request. Set this parameter if you use the pay-by-requester mode. Valid value: requester.

--start-after

string

Sorts objects alphabetically and returns objects that are after the specified value.

--storage-class

string

The storage class of the object. Valid values:

• Standard: Standard.

• IA: Infrequent Access.

• Archive: Archive Storage.

• ColdArchive: Cold Archive.

• DeepColdArchive: Deep Cold Archive.

--tagging

strings

Specifies the tags of the object in the key=value format.

Example: --tagging tag1=value1,tag2=value2.

--tagging-directive

string

The instruction to modify tags. Valid values:

• replace: Retains only the tags specified in the command line options.

• update: Takes the union of the tags in the command line and the tags of the object.

• purge: Clears all tags.

• delete: Deletes the tags specified in the command line options and retains the rest.

--version-id

string

The version ID of the object.

--list-format

string

The format of the list file. Valid values: plain, inventory.

--list-manifest-from

string

Reads the description of the list file format from a file. This parameter is required when the list file format is `inventory`.