List Backups (v2)

You can list available backup snapshots archived by Oracle in the Oracle Object storage Cloud.

You can then restore available backup snapshots (copy them to the environment), To restore backup snapshots, see Restore Backups (v2). After copying the backup, you can archive it or use it to restore the current environment by yourself. With the List Backups and Restore Backup APIs, you do not have to create a service request to request a backup from an environment.

Required Roles

Service Administrator

Any predefined role and Migrations – Administer granular role

REST Resource

GET /interop/rest/v2/backups/list

Response

Supported Media Types: application/json

Table 9-117 Parameters

Attribute	Description
details	Published in case of errors with the error string
status	See Migration Status Codes
links	Detailed information about the link
href	Links to API call
action	The HTTP call type
rel	Possible value: self
intermittentStatus	Stats of each step perormed; can be polled regularly from the job status URL

Example of Response Body

{  
  "details": null,  
  "status": 0,  
  "items": [  
    "2025-10-03T12:45:54/Artifact_Snapshot.zip",  
    "2025-10-04T12:45:49/Artifact_Snapshot.zip",  
    "2025-10-06T12:45:36/Artifact_Snapshot.zip",  
    "2025-10-07T12:45:47/Artifact_Snapshot.zip",  
    "2025-10-08T12:45:36/Artifact_Snapshot.zip",  
    "2025-10-09T12:45:46/Artifact_Snapshot.zip",  
    "2025-10-10T12:45:54/Artifact_Snapshot.zip",  
    "2025-12-03T08:13:34/Artifact_Snapshot.zip"  
  ],  
  "links": [  
    {  
      "href": "https://<BASE-URL>/interop/rest/v2/backups/list",  
      "action": "GET",  
      "rel": "self",  
      "data": null  
    }  
  ]  
}

Sample cURL Command

curl -s -u <USERNAME>:<PASSWORD> -H 'Content-Type: application/json' --request GET -G https://<BASE-URL>/interop/rest/v2/backups/list