Using the radosgw-admin cli for cloud restore operations

Use the radosgw-admin cli to check the cloud-restore status for a specific object or to list all objects in a bucket that are restored or in progress.

Before you begin

Administrator privileges to run radosgw-admin commands.
radosgw-admin tool is installed and available in your $PATH.
Target bucket exists in the cluster.
Restore request is initiated for the object (for status checks).

Procedure

To display detailed restore status for a specific object in the bucket.

radosgw-admin restore status --bucket <bucket-name> --object <object-name>

{ 
    "name": "new", 
    "RestoreExpiryDate": "2025-08-21T13:58:46.970540Z", 
    "RestoreStatus": "CloudRestored", 
    "RestoreType": "Temporary", 
    "RestoreTime": "2025-08-21T13:36:39.618810Z" 
}

Following are the parameter descriptions:

--bucket: Name of the bucket.
--object: Name of the object whose restore status is queried.

To list objects in the bucket that are restored or are in the process of being restored.
```
radosgw-admin restore list --bucket <bucket-name>
```
Following is a sample output (no filter):
```
{ 
    "file": "CloudRestored", 
    "new": "CloudRestored" 
} 

 
```
Following is a sample output (with filter):
```
  radosgw-admin  restore list --bucket <bucket name> --restore-status=CloudRestored  
   { 
    "file": "CloudRestored" 
    } 
   
```
Following are the parameter descriptions:

--bucket

Name of the bucket.

--restore-status=<status>

Filter objects by restore status: RestoreAlreadyInProgress, CloudRestored, or RestoreFailed.

Note: --restore-status=<status> is an optional parameter.
To display the count of restore operations in the bucket stats command.
```
radosgw-admin bucket stats --bucket <bucket-name> --show-restore-stats
```
Following is the sample output:
```
{
  "restore_stats": {
    "restore_completed_count": 0,
    "restore_in_progress_count": 0,
    "restore_failed_count": 0
  }
}
 
```
Following are the parameter descriptions:

--bucket

Name of the bucket to query restore statistics.

--show-restore-stats

Displays restore statistics. Must be set explicitly, statistics are not shown by default.