Restoring Objects from the Archive Storage
Function
You can use this command to restore a specified cold object or restore cold objects with a specific prefix in batches.

- Object content cannot be read during restoration.
- After an object is restored, the time it requires before the object can be downloaded depends on the OBS server.
- obsutil currently does not support the restoration status query. You can use OBS Browser+ or call the API for obtaining object metadata to query the restoration status.

obsutil cannot identify and skip the objects that have been restored. If obsutil repeatedly restores the Archive objects, there will be additional costs for the repeated restore operations. Besides, the validity period of the Standard object copies will be prolonged, and you need to pay for storing these copies during the prolonged period.
Command Line Structure
- In Windows
- Restoring an object
obsutil restore obs://bucket/key [-d=1] [-t=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]
- Restoring objects in batches
obsutil restore obs://bucket[/key] -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]
- Restoring all objects in a specific directory at a time
obsutil restore obs://bucket/folder/ -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]
- Restoring an object
- In Linux or macOS
- Restoring an object
./obsutil restore obs://bucket/key [-d=1] [-t=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]
- Restoring objects in batches
./obsutil restore obs://bucket[/key] -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]
- Restoring all objects in a specific directory at a time
./obsutil restore obs://bucket/folder/ -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]
- Restoring an object
Examples
- Take the Windows OS as an example. Run the obsutil restore obs://bucket-test/key command to restore a single object whose storage class is cold.
obsutil restore obs://bucket-test/key Start at 2024-09-30 08:56:17.9537365 +0000 UTC Start to restore object [key] in the bucket [bucket-test] successfully, cost [252] ms, request id [0000019242250F754015F23EE0B7876E]
- Take the Windows OS as an example. Run the obsutil restore obs://bucket-test -r -f command to restore objects whose storage class is cold in the bucket in batches.
obsutil restore obs://bucket-test -r -f Start at 2024-09-30 08:57:11.3565648 +0000 UTC [================================================] 100.00% 3s Succeed count: 12 Failed count: 0 Metrics [max cost:264 ms, min cost:54 ms, average cost:119.33 ms, average tps:19.70] Task id: 96f104ee-d0bf-40ff-95dd-31dec0d8f4f4
Parameter Description
Parameter |
Optional or Mandatory |
Description |
---|---|---|
bucket |
Mandatory |
The bucket name |
key |
Mandatory for restoring a single object whose storage class is cold Optional for batch restoring objects whose storage class is cold |
The name of the object to be restored or the name prefix of the objects to be restored in batches
NOTE:
If this parameter is left blank when batch restoring objects, all objects whose storage class is cold in the bucket are restored. |
d |
Optional (additional parameter) |
The storage duration after objects whose storage class is cold are restored, in days. The value ranges from 1 to 30. The default value is 1. |
t |
Optional (additional parameter) |
The options for restoring objects. Possible values are:
NOTE:
|
versionId |
Optional for restoring a single object whose storage class is cold (additional parameter) |
The version ID of the to-be-restored object whose storage class is cold |
fs |
Optional (additional parameter) |
Whether the method of listing parallel file systems is applied. If you are listing parallel file systems, you are recommended to add this parameter.
CAUTION:
|
encoding-type |
Optional (additional parameter) |
If the object name contains special characters, set this parameter to url.
NOTE:
This parameter is only supported by obsutil 5.5.12 and later. |
fr |
Optional for restoring a single object whose storage class is cold (additional parameter) |
Generates an operation result file when restoring a single object whose storage class is cold. |
f |
Optional for batch restoring objects whose storage class is cold (additional parameter) |
Runs in force mode. |
r |
Mandatory for batch restoring objects whose storage class is cold (additional parameter) |
Restores objects whose storage class is cold in batches by object name prefix. |
v |
Optional for batch restoring objects whose storage class is cold (additional parameter) |
Restores versions of objects whose storage class is cold in batches by object name prefix. |
o |
Optional (additional parameter) |
The folder that stores the result files. After the command is executed, result files (possibly success and failure files) will be created in the specified folder. The default value is .obsutil_output, a subfolder in the user's home directory where obsutil commands are executed.
NOTE:
|
j |
Optional for batch restoring objects whose storage class is cold (additional parameter) |
The maximum number of concurrent tasks for batch restoring objects whose storage class is cold. The default value is the value of defaultJobs in the configuration file.
NOTE:
The value is ensured to be greater than or equal to 1. |
config |
Optional (additional parameter) |
The user-defined configuration file for executing the current command. To learn the parameters that can be configured in this file, see Configuration Parameters. |
e |
Optional (additional parameter) |
The endpoint |
i |
Optional (additional parameter) |
The user's AK |
k |
Optional (additional parameter) |
The user's SK |
token |
Optional (additional parameter) |
The user's security token |
Response
Refer to Response for uploading an object.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot