Oracle Cloud Infrastructure Documentation

Restoring an Object Storage Object from Archive Storage

Restore an object from Archive Storage to Object Storage.

Depending on the size of the object, it can take at most an hour to restore an object from Archive Storage. You can't download an item object until the item is fully restored.

To restore objects from Archive Storage, you need OBJECT_RESTORE permissions.

    1. Open the navigation menu and click Storage. Under Object Storage & Archive Storage, click Buckets.

    2. Select the compartment from the list under List Scope. All buckets in that compartment are listed in tabular form.

    3. Click the bucket whose object you want to restore. The bucket's Details page appears.

    4. Click Objects under Resources. The Objects list appears. All folders and objects are listed in tabular form.

    5. Click the Actions menu (Actions Menu) next to the object name, and selectRestore. To restore multiple objects, select the check boxes next to the object names and select Restore from the More Actions menu. The Restore Object dialog box appears.

    6. Optionally, specify the Time Available for Download in Hours.

      By default, you have 24 hours to download an object after restoration. However you can alternatively specify a download time of from 1 to 240 hours. You can find out how much download time is remaining by looking at Available for Download in object Details or by looking at the Actions menu (Actions Menu) next to the Download. Refresh the browser to obtain up-to-date remaining download time information.

      After the allotted download time expires, the object returns to Archive Storage.

    7. Click Restore Objects.

      Error messages are generated if there's a problem with restoring the selected objects. You can optionally click Retry failed restore option.

    8. Click the Actions menu (Actions Menu) next to the object you want to check the restoration or download status of, then click Details.

    9. Check the Status.

      • Archived

      • Restoring

      • Restored

  • Use the oci os object restore-status command and required parameters to get that status of an object being restored from Archive Storage to Object Storage in a bucket:

    oci os object restore-status --bucket-name archive_bucket_name --name archived_object_name [OPTIONS]

    By default, you have 24 hours to download an object after restoration. However, you can include the optional hours parameter with an integer value of download time of from 1 to 240 hours. For example:

    oci os object restore --bucket-name MyArchiveBucket --name MyArchivedObject --hours 12
    You need OBJECT_RESTORE permissions to restore Archive Storage objects.

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the RestoreObjects operation to restore an object from Archive Storage to Object Storage.

    Object Storage prepends the Object Storage namespace string and bucket name to the object name when constructing a URL for use with the API: 

    /n/object_storage_namespace/b/bucket/o/object_name

    The object name is everything after the /o/, which could include hierarchy levels and prefix strings.