View the Backup Configuration
get
/api/v1.1/instances/{identityId}/{serviceId}/backupconfig
Returns the backup configuration for a service instance.
Request
Path Parameters
- identityId
-
Type:
string
Required:true
Name of the identity domain for the Oracle Cloud Service account.- serviceId
Type:string
Required:true
ID of the service instance.
Response
Supported Media Types
- application/json
200 Response
success
Body
Root Schema : ViewBackupConfigurationResponse
Type:
object
- cloudStorageContainer
-
Type:
string
Required:true
Oracle Cloud Storage Service container name. - defaultRetention
-
Type:
string
Required:true
Number of days the incremental backups are retained.
Full backups are retained until their last related incremental backup is available.
If set to null, backups are retained indefinitely or until you manually delete them. - fullBackupSchedule
-
Type:
object
fullBackupScheduleRequired:true
Schedule for the next full backup.
By default, full backups are initiated weekly starting 12 hours after a service instance was created, rounded to the nearest five-minute interval. - incrementalBackupSchedule
-
Type:
object
incrementalBackupScheduleRequired:true
Schedule for the next incremental backup.
By default, incremental backups are initiated every day except the day of a full backup at the same time that full backups are initiated.
Units are the same as for 'fullBackupSchedule'. - lastBackupDate
-
Type:
string
Required:true
Date and time that the last backup completed.
Note: If there have been no backups, this attribute is omitted. - nextFullBackupDate
-
Type:
string
Required:true
Scheduled date and time for next full backup. - nextIncrementalBackupDate
-
Type:
string
Required:true
Scheduled date and time for next incremental backup. - percentBackupVolumeUsed
-
Type:
integer
Required:true
Total percent of the backup volume that is currently in use. - totalBackupVolumeUsed
-
Type:
string
Required:true
Total amount, in MBs, of the backup volume that is currently in use. - totalCloudStorageContainerUsed
-
Type:
string
Required:true
Total amount, in MBs, of Cloud Storage Container space that is currently in use.
Nested Schema : fullBackupSchedule
Type:
object
Schedule for the next full backup.
By default, full backups are initiated weekly starting 12 hours after a service instance was created, rounded to the nearest five-minute interval.
By default, full backups are initiated weekly starting 12 hours after a service instance was created, rounded to the nearest five-minute interval.
- dayOfMonth
-
Type:
string
Non-configurable item. '*' (all days) - dayOfWeek
-
Type:
string
Configurable item - hour
-
Type:
string
Configurable item - minute
-
Type:
string
Configurable item - month
-
Type:
string
Non-configurable item. '*' (all months) - second
-
Type:
string
Non-configurable item. Defaults to '0' - year
-
Type:
string
Non-configurable item. '*' (all years)
Nested Schema : incrementalBackupSchedule
Type:
object
Schedule for the next incremental backup.
By default, incremental backups are initiated every day except the day of a full backup at the same time that full backups are initiated.
Units are the same as for 'fullBackupSchedule'.
By default, incremental backups are initiated every day except the day of a full backup at the same time that full backups are initiated.
Units are the same as for 'fullBackupSchedule'.
- dayOfMonth
-
Type:
string
Day Of Month - dayOfWeek
-
Type:
string
Day Of Week - hour
-
Type:
string
hours - minute
-
Type:
string
minutes - month
-
Type:
string
Month - second
-
Type:
string
seconds - year
-
Type:
string
Year
Examples
The following example shows how to view the backup configuration for an Oracle SOA Cloud Service instance by submitting a GET request on the REST resource using cURL. For more information, see Use cURL.
See also Configuring Automated Backups for an Oracle SOA Cloud Service Instance.
cURL Command
curl -i -X GET -u joe@example.com:Welcome1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://api-host/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance/backupconfig
Note:: This example uses the URL prefix for the United States (
soacs). For information about the URL prefixes for other regions of the world, see
Send Requests.
Example of Response Header
The following shows an example of the response header:
HTTP/1.1 200 OK Date: Wed, 04 Feb 2015 14:37:25 GMT Transfer-Encoding: chunked Content-Type: application/json
Example of Response Body
The following example shows the response returned in JSON format.
{ "defaultRetention":"30 days", "fullBackupSchedule": { "second":"0", "minute":"25", "hour":"7", "dayOfMonth":"*", "month":"*", "dayOfWeek":"Tue", "year":"*" }, "incrementalBackupSchedule": { "second":"0", "minute":"25", "hour":"7", "dayOfMonth":"*", "month":"*", "dayOfWeek":"Sun,Mon,Wed,Thu,Fri,Sat", "year":"*" }, "lastBackupDate":"Thu Dec 11 07:25:00 GMT 2014", "nextFullBackupDate":"Tue Dec 16 07:25:00 GMT 2014", "nextIncrementalBackupDate":"Fri Dec 12 07:25:00 GMT 2014", "cloudStorageContainer":"develop-soa\/mybackupcontainer", "totalCloudStorageContainerUsed":"0.0MB", "totalBackupVolumeUsed":"853.5MB", "percentBackupVolumeUsed":0 }