View All Deleted Backups
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/deletedbackups
For complete information about contents of backups, where backups are stored, and how backups and local copies of backups are deleted automatically, see About Backup and Restoration in Administering Oracle Java Cloud Service.
Request
-
identityDomainId: string
Identity domain ID for the Oracle Java Cloud Service account.
-
serviceId: string
Name of the Oracle Java Cloud Service instance.
-
Authorization: string
Base64 encoded user name and password separated by a colon or OAuth access token obtained from Oracle Identity Cloud Service. See Authenticate.
-
X-ID-TENANT-NAME: string
Identity domain ID for the Oracle Java Cloud Service account.
Response
200 Response
object
-
deletedbackups(optional):
array deletedbackups
Groups all deleted backups.
object
-
backupId(optional):
string
Backup ID.
-
backupStartDate(optional):
string
Date and time that the backup started.
-
databaseIncluded(optional):
boolean
Flag that specifies whether a database backup was performed as part of a backup operation on the Oracle Java Cloud Service instance. If
false
, a database backup was not performed. Iftrue
, a database backup was performed.Note: This attribute is always
false
on Oracle Java Cloud Service instances that that are associated with the following database services for the required infrastructure schema:- Oracle Autonomous Transaction Processing
- Oracle Cloud Infrastructure Database (DB system)
- Oracle Database Exadata Cloud Service
-
dbTag(optional):
string
An RMAN tag or a timestamp. This attribute is included only if a database backup was performed as part of the Oracle Java Cloud Service instance backup.
When the associated database deployment is hosting a single-instance database, the attribute value is the RMAN tag that identifies the specific database files backed up. When the associated database deployment is hosting an Oracle Real Application Clusters (RAC) database, the attribute value is the timestamp of the database backup.
-
deletedOnDate(optional):
string
Date and time that the backup deletion completed.
-
expirationDate(optional):
string
Date and time that the backup is deleted automatically from storage. If the value is
null
, the backup is retained indefinitely or until you manually delete it. (Value isnull
whenkeepForever
was set totrue
for an on-demand backup.) -
full(optional):
boolean
Flag that specifies whether this was a full (
true
) or incremental (false
) backup. -
href(optional):
string
URI of the backup resource.
-
initiatedBy(optional):
string
User account that initiated the operation. Value is
scheduled
for scheduled automated operations. -
jobId(optional):
string
Job ID for the delete backup operation.
-
local(optional):
boolean
Flag that specifies whether the backup is downloaded and stored locally in block storage on the Administration Server host (
true
), or archived and stored remotely (false
). The remote storage is the specified object storage container or bucket. -
localCopy(optional):
boolean
Flag that specifies whether the local copy of a backup is maintained for a backup that has been uploaded to remote storage. The remote storage is the specified object storage container or bucket.
-
notes(optional):
string
Free-form text that provides additional information about the backup.
-
size(optional):
string
Size of the backup, in MBs.
-
sizeInBytes(optional):
integer
Size of the backup, in Bytes.
-
status(optional):
string
Status of the backup. Valid value is
Deleted
. -
storageContainer(optional):
string
Where service instance backups are stored.
Examples
The following example shows how to view information about all deleted backups for an Oracle Java Cloud Service instance by submitting a GET request on the REST resource using cURL.
Note: The command in this example uses the URL structure https://rest_server_url/resource-path
, where rest_server_url
is the REST server to contact for your identity domain (or Cloud Account). See Send Requests.
cURL Command
curl -i -X GET -u username:password -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/deletedbackups
Example of Response Header
The following shows an example of the response header:
HTTP/1.1 200 OK
Date: Sat, 12 Dec 2015 01:50:11 GMT
Transfer-Encoding: chunked
Content-Type: application/json
Example of Response Body
The following example shows a response returned in JSON format. Your output will differ depending on your Oracle Java Cloud Service environment, service instance configuration, and backup configuration.
{
"deletedbackups":[
{
"backupId":"1444395600241",
"jobId":"300748",
"backupStartDate":"Fri Oct 09 13:00:00 GMT 2015",
"expirationDate":"Sat Nov 14 13:00:00 GMT 2015",
"deletedOnDate":"Mon Nov 16 13:21:23 GMT 2015",
"initiatedBy":"scheduled",
"full":true,
"local":false,
"localCopy":false,
"databaseIncluded":true,
"size":"1712.8MB",
"sizeInBytes":1795953008,
"dbTag":"TAG20151009T131630",
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomainID\/services\/jaas\/instances\/ExampleInstance\/backups\/1444395600241",
"notes":"Automated backup"
},
{
"backupId":"1444482000267",
"jobId":"300746",
"backupStartDate":"Sat Oct 10 13:00:00 GMT 2015",
"expirationDate":"Mon Nov 09 13:00:00 GMT 2015",
"deletedOnDate":"Mon Nov 16 13:20:20 GMT 2015",
"initiatedBy":"scheduled",
"full":false,
"local":false,
"localCopy":false,
"databaseIncluded":true,
"size":"52.1MB",
"sizeInBytes":54682556,
"dbTag":"TAG20151010T130457",
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomainID\/services\/jaas\/instances\/ExampleInstance\/backups\/1444482000267",
"notes":"Automated backup"
},
...
{
"backupId":"1447938000367",
"jobId":"325323",
"backupStartDate":"Thu Nov 19 13:00:00 GMT 2015",
"expirationDate":"Sat Dec 19 13:00:00 GMT 2015",
"deletedOnDate":"Wed Nov 25 19:30:07 GMT 2015",
"initiatedBy":"scheduled",
"full":false,
"local":false,
"localCopy":true,
"databaseIncluded":true,
"size":"388.8MB",
"sizeInBytes":407662990,
"dbTag":"TAG20151119T131258",
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomainID\/services\/jaas\/instances\/ExampleInstance\/backups\/1447938000367",
"notes":"Automated backup"
},
{
"backupId":"1448110800502",
"jobId":"325320",
"backupStartDate":"Sat Nov 21 13:00:00 GMT 2015",
"expirationDate":"Mon Dec 21 13:00:00 GMT 2015",
"deletedOnDate":"Wed Nov 25 19:27:02 GMT 2015",
"initiatedBy":"scheduled",
"full":false,
"local":false,
"localCopy":true,
"databaseIncluded":true,
"size":"387.3MB",
"sizeInBytes":406099518,
"dbTag":"TAG20151121T131441",
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomainID\/services\/jaas\/instances\/ExampleInstance\/backups\/1448110800502",
"notes":"Automated backup"
}
]
}