Object Storage Service:restore (Restore objects)

Parameter

Type

Description

--days

int

The number of days the restored object remains accessible. Valid values: 1 to 365.

When you run a batch operation on objects from different storage classes, if the specified number of days exceeds the maximum allowed for a storage class, the value is automatically adjusted to that class's maximum. For example, the maximum duration for Archive Storage is 7 days, and for Deep Cold Archive Storage is 365 days. If you set --days to 100, the duration is automatically set to 7 for Archive Storage objects and remains 100 for Deep Cold Archive Storage objects.

--tier

string

The restoration priority. This parameter is not required for Archive Storage objects, as they restore in about one minute.

• Cold Archive Storage:

  • Expedited: Restoration completes within 1 hour.

  • Standard: Restoration completes within 2 to 5 hours.

  • Bulk: Restoration completes within 5 to 12 hours.

• Deep Cold Archive Storage:

  • Expedited: Restoration completes within 12 hours.

  • Standard: Restoration completes within 48 hours.

When you batch-restore objects from different storage classes, if a specified tier is not supported by a class, it is automatically adjusted to the lowest supported priority for that class. For example, Cold Archive Storage supports the Bulk tier, but Deep Cold Archive Storage supports only the Standard tier. If you set --tier to Bulk, the tier for any Deep Cold Archive Storage objects in the batch is automatically adjusted to Standard.

--dirs

/

Lists objects and subdirectories in the specified directory, but not recursively.

--encoding-type

string

The encoding type of the object or file names to be processed. Valid value: url.

--end-with

string

Lists objects that are alphabetically at or before the specified value.

--exclude

stringArray

Exclusion rules for paths or object names.

--exclude-from

stringArray

Reads exclusion rules from a file.

--files-from

stringArray

Reads a list of source file names from a file. Blank lines and comment lines are ignored.

--files-from-raw

stringArray

Reads a list of source file names from a file.

--filter

stringArray

Filter rules for paths or object names.

--filter-from

stringArray

Reads filter rules from a file.

-f, --force

/

Forces the operation without prompting for confirmation.

--include

stringArray

Inclusion rules 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 using the ListObjects operation.

--min-age

Duration

Excludes objects that are newer than the specified value. The default unit is seconds. You can also use a unit suffix, such as 1h for one hour.

--max-age

Duration

Excludes objects that are older than the specified value. The default unit is seconds. You can also use a unit suffix, such as 1h for one hour.

--min-mtime

Time

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

--max-mtime

Time

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

--max-size

SizeSuffix

The maximum size of an object to restore. The default unit is bytes. You can use suffixes such as B, K, M, G, T, or P. 1 K (KiB) equals 1,024 bytes.

--metadata-exclude

stringArray

Exclusion rules for object metadata.

--metadata-filter

stringArray

Filter rules for object metadata.

--metadata-filter-from

stringArray

Reads filter rules for object metadata from a file.

--metadata-include

stringArray

Inclusion rules for object metadata.

--min-size

SizeSuffix

The minimum size of an object to restore. The default unit is bytes. You can use suffixes such as B, K, M, G, T, or P. 1 K (KiB) equals 1,024 bytes.

--page-size

int

The maximum number of objects to list per page in batch operations. Default value: 1000. Valid values: 1 to 1000.

-r, --recursive

/

Recursively performs the operation on all matching objects under the specified prefix. Without this option, the command applies only to the specified object.

--request-payer

string

Specifies the payer for the request. Set this to requester for buckets in Requester Pays mode.

--start-after

string

Lists objects that are alphabetically after the specified value, excluding the value itself.

--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

Reads the description of the list file format from a manifest file. This parameter is required when --list-format is set to inventory.