Fleet Schedule Backup
post
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/databases/actions/bulkSubmitBackup
Schedules backup of multiple databases. If the selected destination is an Oracle Zero Data Loss Recovery Appliance, then you must enable the ZDLRA Management Pack on the Recovery Appliance to use this API.
Request
Header Parameters
-
ORCL-EM-DBTARGET-AUTHORIZATION(required):
Database credentials used to connect to the databases.
-
ORCL-EM-HOSTTARGET-AUTHORIZATION(required):
Host credentials that are operating system credentials used to perform database backup and recovery operations.
-
ORCL-EM-RMANTARGET-AUTHORIZATION:
Named credential for RMAN encryption password.
Supported Media Types
- application/json
Root Schema : schema
Type:
objectParameters for creating a backup.
Match All
Parameters for creating a backup.
Show Source
-
object
BackupDetailsCommon
Parameters for creating a backup.
Match One Schema
Show Source
-
Control file Backup Strategy
-
CreateBackupDetailsTapeSuggested
Parameters for creating tape suggested backup.
-
CreateBackupDetailsTapeCustom
Parameters for creating tape custom backup.
-
CreateBackupDetailsOCI
Parameters for creating OCI backup.
-
CreateBackupDetailsDiskCustom
Parameters for creating disk custom backup.
-
CreateBackupDetailsDiskSuggested
Parameters for creating disk suggested backup.
-
CreateBackupDetailsRASuggested
Parameters for creating Recovery Appliance suggested backup.
Nested Schema : BackupDetailsCommon
Type:
objectParameters for creating a backup.
Show Source
-
backupStrategy: string
Allowed Values:
[ "ORACLE_SUGGESTED", "CUSTOM", "CONTROL_FILE" ]Backup strategy.Example:ORACLE_SUGGESTED -
destinationMediaType: string
Allowed Values:
[ "OCI", "RA" ]Destination media type.Example:RA -
targets: array
Targets
List of database targets.
Nested Schema : CreateBackupDetailsTapeSuggested
Parameters for creating tape suggested backup.
Match All
Parameters for creating tape suggested backup.
Parameters for creating tape suggested backup.
Show Source
-
object
BackupDetailsTapeSuggested
Parameters for creating a backup.
-
object
BackupDetailsDPParamsSchedule
Parameters for scheduling a backup.
Nested Schema : CreateBackupDetailsTapeCustom
Parameters for creating tape custom backup.
Match All
Parameters for creating tape custom backup.
Parameters for creating tape custom backup.
Parameters for creating tape custom backup.
Show Source
-
object
BackupDetailsEncryption
Parameters for creating a backup.
-
object
CreateBackupDetailsBase
Parameters for creating a backup.
-
object
BackupDetailsDPParamsSchedule
Parameters for scheduling a backup.
Nested Schema : CreateBackupDetailsOCI
Parameters for creating OCI backup.
Match All
Parameters for creating OCI backup.
Parameters for creating OCI backup.
Parameters for creating OCI backup.
Show Source
-
object
CreateBackupDetailsBase
Parameters for creating a backup.
-
object
BackupDetailsEncryption
Parameters for creating a backup.
-
object
BackupDetailsDPParamsSchedule
Parameters for scheduling a backup.
Nested Schema : CreateBackupDetailsDiskCustom
Parameters for creating disk custom backup.
Match All
Parameters for creating disk custom backup.
Parameters for creating disk custom backup.
Parameters for creating disk custom backup.
Show Source
-
object
BackupDetailsEncryption
Parameters for creating a backup.
-
object
CreateBackupDetailsBase
Parameters for creating a backup.
-
object
BackupDetailsDPParamsSchedule
Parameters for scheduling a backup.
Nested Schema : CreateBackupDetailsDiskSuggested
Parameters for creating disk suggested backup.
Match All
Parameters for creating disk suggested backup.
Parameters for creating disk suggested backup.
Show Source
-
object
BackupDetailsEncryption
Parameters for creating a backup.
-
object
BackupDetailsDPParamsSchedule
Parameters for scheduling a backup.
Nested Schema : CreateBackupDetailsRASuggested
Parameters for creating Recovery Appliance suggested backup.
Match All
Parameters for creating Recovery Appliance suggested backup.
Parameters for creating Recovery Appliance suggested backup.
Show Source
-
object
BackupDetailsRASuggested
Parameters for creating a backup.
-
object
BackupDetailsDPParamsSchedule
Parameters for scheduling a backup.
Nested Schema : Targets
Type:
arrayList of database targets.
Show Source
Example:
[
{
"targetName":"DB1",
"targetTypeName":"oracle_database",
"rmanEncryptionCredentials":"NAMED:RMAN:SYSMAN"
},
{
"targetName":"DB2",
"targetTypeName":"rac_database"
}
]Nested Schema : items
Type:
Show Source
object-
rmanEncryptionCredentials: string
Named credential for RMAN encryption password at a database target level.Example:
NAMED:RMAN:SYSMAN -
targetName: string
Target name.Example:
DB1 -
targetTypeName: string
Target type.Example:
oracle_database
Nested Schema : BackupDetailsTapeSuggested
Type:
objectParameters for creating a backup.
Show Source
-
mmvLibraryParameters: string
Media Management Vendor library parameters.Example:
SBT_LIBRARY=C:\DB19c\obase\ohome\db_home1\bin\oraopc.dll,SBT_PARMS=(OPC_PFILE=C:\DB19c\obase\ohome\db_home1\dbs\opcwcdb19.ora) -
recoveryWindowInDays: integer
Recovery window in days.Example:
31 -
tapeDrives: integer
Tape drives.Example:
1
Nested Schema : BackupDetailsDPParamsSchedule
Type:
objectParameters for scheduling a backup.
Show Source
-
schedule:
Discriminator: type
Discriminator:
{ "propertyName":"type", "mapping":{ "immediately":"#/components/schemas/ScheduleImmediately", "later":"#/components/schemas/ScheduleLater", "repeating":"#/components/schemas/ScheduleRepeating" } }Specifies schedule of the deployment procedure..
Nested Schema : Discriminator: type
Type:
objectDiscriminator: type
Discriminator Values
Specifies schedule of the deployment procedure..
Match One Schema
Show Source
-
immediately -
object
ScheduleImmediately
Schedule immediately.
-
later -
object
ScheduleLater
Schedule later.
-
object
Discriminator: repeatFrequency
Discriminator:
{ "propertyName":"repeatFrequency", "mapping":{ "WEEKLY":"#/components/schemas/ScheduleWeekly", "MONTHLY":"#/components/schemas/ScheduleMonthly", "YEARLY":"#/components/schemas/ScheduleYearly", "INTERVAL":"#/components/schemas/ScheduleInterval" } }Repeating schedule.
Nested Schema : ScheduleImmediately
Type:
objectSchedule immediately.
Show Source
-
type(required): string
Type of schedule.Example:
immediately
Nested Schema : ScheduleLater
Type:
objectSchedule later.
Show Source
-
startTime:
date-timeDate when the deployment procedure is scheduled to start. Specified as a string in the format yyyy/MM/dd HH:mm.Example:2021/08/30 23:00 -
timeZone: string
Java Timezone.Example:
America/New_York -
type(required): string
Type of schedule.Example:
later
Nested Schema : Discriminator: repeatFrequency
Type:
objectDiscriminator: repeatFrequency
Discriminator Values
Repeating schedule.
Match All
Repeating schedule.
Show Source
-
object
ScheduleRepeatingBase
Repeating schedule.
Match One Schema
Show Source
-
WEEKLY -
object
ScheduleWeekly
Repeat value for repeat frequency - weekly.
-
MONTHLY -
object
ScheduleMonthly
Repeat value for repeat frequency - monthly.
-
YEARLY -
object
ScheduleYearly
Repeat value for repeat frequency - yearly.
-
INTERVAL -
object
ScheduleInterval
Repeat value for repeat frequency - interval.
Nested Schema : ScheduleRepeatingBase
Type:
objectRepeating schedule.
Show Source
-
endtime:
date-timeDate when job expires. Specified as a string in the format yyyy/MM/dd HH:mm. If not specified, repeat would be on forever.Example:2021/08/30 23:00 -
repeatFrequency(required): string
Allowed Values:
[ "WEEKLY", "MONTHLY", "YEARLY", "INTERVAL" ]Repetitive frequency type. -
startTime(required):
date-timeDate when the deployment procedure is scheduled to start. Specified as a string in the format yyyy/MM/dd HH:mm.Example:2021/08/30 23:00 -
timeZone: string
Java Timezone.Example:
America/New_York -
type(required): string
Type of schedule.Example:
repeating
Nested Schema : ScheduleWeekly
Type:
objectRepeat value for repeat frequency - weekly.
Show Source
-
days(required): array
days
Days of the week.
Nested Schema : ScheduleMonthly
Type:
objectRepeat value for repeat frequency - monthly.
Show Source
-
days(required): array
days
Repeat value for monthly.
Nested Schema : ScheduleYearly
Type:
objectRepeat value for repeat frequency - yearly.
Show Source
-
months(required): array
months
Repeat value for yearly.
Nested Schema : ScheduleInterval
Type:
objectRepeat value for repeat frequency - interval.
Show Source
-
repeatEvery(required): string
Repeat every N value - m(minutes), h(hours), d(days), w(week).Example:
10m, 3h, 5d, 2w
Nested Schema : days
Type:
arrayDays of the week.
Show Source
-
Array of:
integer
Allowed Values:
[ 1, 2, 3, 4, 5, 6, 7 ]Days of the week, Sunday is 1, Monday is 2 etc.
Example:
1,4Nested Schema : days
Type:
arrayRepeat value for monthly.
Show Source
-
Array of:
integer
Day number, int -1, 1..5 representing which day number. -1 represents LAST day.
Example:
1,30,31Nested Schema : months
Type:
arrayRepeat value for yearly.
Show Source
-
Array of:
integer
Month number, int 1, 2, 3.. representing months Januaray, February, March etc.
Example:
1,3Nested Schema : BackupDetailsEncryption
Type:
objectParameters for creating a backup.
Show Source
-
backupEncryptionMode: string
Allowed Values:
[ "WALLET", "PASSWORD", "BOTH" ]Backup Encryption ModeExample:PASSWORD -
encryptionAlogrithm: string
Allowed Values:
[ "AES128", "AES192", "AES256" ]Encryption AlogrithmExample:AES128
Nested Schema : CreateBackupDetailsBase
Type:
objectParameters for creating a backup.
Show Source
-
backupScope: string
Allowed Values:
[ "WHOLE" ]Backup Scope.Example:WHOLE -
backupType: string
Allowed Values:
[ "FULL", "INCREMENTAL0", "INCREMENTAL1" ]Backup Type.Example:INCREMENTAL0 -
incrementalType: string
Allowed Values:
[ "DIFFERENTIAL", "CUMULATIVE" ]Incremental Type.Example:DIFFERENTIAL -
isDeleteArchivedLogsPostBackup: boolean
Specifies if the archived logs have to be deleted after a successful backup.Example:
false -
isDeleteObsoleteBackups: boolean
Specifies if the obsolete backups have to be deleted.Example:
false -
isSkipBackupArchivedLogs: boolean
Specifies if archived logs have to be skipped during backup.Example:
false -
maxFilesPerSet: integer
Maximum files per backupset.Example:
1 -
sectionSizeInMBs: integer
Section size of the backup.Example:
10
Nested Schema : BackupDetailsRASuggested
Type:
objectParameters for creating a backup.
Show Source
-
isCrosscheckArchivelog: boolean
Specifies whether the crosscheck archived log has to be performed.Example:
true -
isDeleteArchivedLogsPostBackup: boolean
Specifies whether the archived log has be deleted after a successful backup.Example:
true
Examples
Back to Top
Response
Supported Media Types
- application/json
202 Response
Accepted.
Headers
-
Content-Location:
Execution details of the deployment procedure submitted.
-
ORCL-EM-PROCESSING-TIME:
Elapsed time (in milliseconds) since the deployment procedure is submitted.
Root Schema : BulkSubmitBackupDatabase
Type:
objectBackup Deployment Procedure Status
Show Source
-
code(required): integer
HTTP Status codeExample:
202 -
executionId(required): string
Deployment procedure execution ID.
-
instanceName(required): string
Instance name of the deployment procedure submitted.
-
procedureId(required): string
Deployment procedure submission ID.
-
submissionBy(required): string
User that submitted the deployment procedure.
-
submissionName(required): string
Name of the deployment procedure submitted.
400 Response
Bad Request
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an Error
Show Source
-
code(required): string
The status code of the error
-
message(required): string
A descriptive error message
401 Response
Unauthorized
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an Error
Show Source
-
code(required): string
The status code of the error
-
message(required): string
A descriptive error message
403 Response
Forbidden
Root Schema : MissingPrivErrorResponse
Type:
objectResponse sent back as an Error in case required privileges are missing
Show Source
-
missingPrivileges: array
missingPrivileges
Privileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object
Match All
Response sent back as an Error in case required privileges are missing
Show Source
-
object
ErrorResponse
Response sent back in the case of an Error
Nested Schema : missingPrivileges
Type:
arrayPrivileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object
Show Source
-
Array of:
object MissingPrivilegeSummary
It represents a Privilege which is missing on a Resource to view or manage it.
Nested Schema : ErrorResponse
Type:
objectResponse sent back in the case of an Error
Show Source
-
code(required): string
The status code of the error
-
message(required): string
A descriptive error message
Nested Schema : MissingPrivilegeSummary
Type:
objectIt represents a Privilege which is missing on a Resource to view or manage it.
Show Source
-
displayName: string
Display Name of PrivilegeExample:
Manage -
name: string
Name of PrivilegeExample:
MANAGE_JOB
404 Response
Not Found
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an Error
Show Source
-
code(required): string
The status code of the error
-
message(required): string
A descriptive error message
409 Response
Duplicate Resource
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an Error
Show Source
-
code(required): string
The status code of the error
-
message(required): string
A descriptive error message
500 Response
Internal Server Error
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an Error
Show Source
-
code(required): string
The status code of the error
-
message(required): string
A descriptive error message
503 Response
Service Unavailable
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an Error
Show Source
-
code(required): string
The status code of the error
-
message(required): string
A descriptive error message