Object Storage Service:restore

Parameter

Type

Description

--days

int

The duration within which the object remains in the restored state. Unit: days. Valid values: 1 to 365.

When you perform operations on multiple objects in different storage classes at a time, and the value of the --days parameter exceeds the maximum duration for a specific storage class, the value is automatically set to the maximum duration for the storage class. For example, the maximum duration supported by Archive is 7 days, and the maximum duration supported by Deep Cold Archive is 365 days. If you set the --days parameter to 100, the duration for Archive objects is automatically set to 7 days and the duration for Deep Cold Archive objects is automatically set to 100 days.

--tier

string

The restoration priority. You do not need to specify this parameter for Archive objects. The restoration requires approximately 1 minute.

• Cold Archive：

  • Expedited: The object is restored within 1 hour.

  • Standard: The object is restored within 2~5 hours.

  • Bulk: The object is restored within 5~12 hours.

• Deep Cold Archive：

  • Expedited: The object is restored within 12 hours.

  • Standard: The object is restored within 48 hours.

When you perform operations on multiple objects in different storage classes at a time, if the value of the --tier parameter exceeds the priority value supported by the storage class, the value is automatically set to the lowest priority for the storage class. For example, Cold Archive objects support Bulk, while Deep Cold Archive objects only support Standard. In this case, the restoration priority is automatically adjusted to Standard if you set the --tier parameter to Bulk.

--dirs

/

Lists objects and subdirectories in the current directory, instead of recursively displaying all objects in all subdirectories.

--encoding-type

string

The encoding method used to encode the object name. Valid value: url.

--end-with

string

Specifies that objects whose names are alphabetically before or the same as the value of the --end-with parameter are returned.

--exclude

stringArray

Specifies an exclusion rule for paths or object names.

--exclude-from

stringArray

Reads exclusion rules from a file.

--files-from

stringArray

Reads object names from a file, with empty lines or comment lines ignored.

--files-from-raw

stringArray

Reads object names from a file, without ignoring empty lines and comment lines.

--filter

stringArray

Specifies a filter rule for paths or object names.

--filter-from

stringArray

Reads filter rules from a file.

-f, --force

/

Forces the operation without requiring confirmation.

--include

stringArray

Specifies an inclusion rule for paths or object names.

--include-from

stringArray

Reads inclusion rules from a file.

--limited-num

int

The maximum number of results to return.

--list-objects

/

Lists objects by calling the ListObjects operation.

--max-age

Duration

Excludes objects whose last modified time is earlier than the value of this parameter. The default unit is s (seconds). You can suffix the numerical value with a unit: ms for milliseconds, s for seconds, m for minutes, h for hours, d for days, w for weeks, M for months, or y for years.

--max-mtime

Time

Excludes objects whose last modified time is later than the value of this parameter. The time must be in UTC.

--max-size

SizeSuffix

The maximum size of an object that can be transferred. By default, the size is in bytes (B). You can suffix the numerical value with a 1024-based unit: B for byte, K for Kibibyte, M for Mebibyte, G for Gibibyte, T for Tebibyte, or P for Pebibyte.

--metadata-exclude

stringArray

Specifies an exclusion rule for object metadata.

--metadata-filter

stringArray

The filter rule for object metadata.

--metadata-filter-from

stringArray

Reads metadata filter rules from a file.

--metadata-include

stringArray

Specifies an inclusion rule for object metadata.

--min-age

Duration

Excludes objects whose last modified time is later than the value of this parameter. The default unit is s (seconds). You can suffix the numerical value with a unit: ms for milliseconds, s for seconds, m for minutes, h for hours, d for days, w for weeks, M for months, or y for years.

--min-mtime

Time

Excludes objects whose last modified time is earlier than the value of this parameter. The time must be in UTC.

--min-size

SizeSuffix

The minimum size of a file and object that can be transferred. By default, the size is in bytes (B). You can suffix the numerical value with a 1024-based unit: B for byte, K for Kibibyte, M for Mebibyte, G for Gibibyte, T for Tebibyte, or P for Pebibyte.

--page-size

int

The maximum number of objects to return per page. Valid values: 1 to 1000. Default value: 1000.

-r, --recursive

/

Specifies that the command performs the operation recursively. If this parameter is specified, the command performs the operation on all matching objects in the bucket. If this parameter is not specified, the command performs the operation only on the specified objects in the specified path.

--request-payer

string

The payer of the request. If pay-by-requester is enabled, specify this parameter. Valid value: requester.

--start-after

string

Specifies that objects whose names are alphabetically before or the same as the value of the --end-with parameter are returned.

--version-id

string

The version ID of the object.

--list-format

string

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

--list-manifest-from

string

Read the format description of the list file from the file. You are required to specify this parameter if the format is inventory.