List Backups - Only for OCI (Gen 2) Environments
In OCI (Gen 2) environments, 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 in OCI (Gen 2) environments, see Restore Backup. 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 no longer have to create a service request to request a backup from an OCI environment.
This API is version v2.
Required Roles
Service Administrator
Power User assigned to the Migration Administrator Profitability and Cost Management application role
REST Resource
GET /interop/rest/v2/backups/list
Note:
Before using the REST resources, you must understand how to access the REST resources and other important concepts. See Implementation Best Practices for EPM Cloud REST APIs. Using this REST API requires prerequisites. See Prerequisites.
Response
Supported Media Types: application/json
Parameters:
Table 9-112 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
The following shows an example of the response body in JSON format.
{
"details": null,
"links": [{
"href": "https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/interop/rest/v2/backups/list",
"rel": "self",
"data": null,
"action": "GET"
}],
"status": 0,
"items": ["2022-02-16T05:49:15/Artifact_Snapshot.zip", "2022-02-18T05:44:54/Artifact_Snapshot.zip"]
}