Perform Operation
post
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/fleetOperations
Performs all the individual maintenance tasks on the targets. Tasks include- deploy software, migrate listener, update, upgrade, rollback, cleanup, attachCdb, deployCdb, updatePdb, upgradePdb, rollbackPdb, emergencyDeploy, etc. Operations to be performed using FPP will require inputs related to the FPP operations
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
objectMatch All
Show Source
-
object
CreateFleetOperationDetails
Fleet operation inputs
Nested Schema : CreateFleetOperationDetails
Type:
objectFleet operation inputs
Match Any
Show Source
-
object DeployDetails
Deploy operation input
-
object AttachCdbDetails
Attach CDB operation input
-
object DeployCdbDetails
Deploy CDB operation input
-
object EmergencyDeployDetails
Emergency deploy operation input
-
object MigrateListenerDetails
Migrate listener operation input
-
object UpdateDetails
Update operation input
-
object UpdatePdbDetails
Update PDB operation input
-
object UpgradeDetails
Upgrade operation input
-
object UpgradePdbDetails
Upgrade PDB operation input
-
object AttachCdbDetails
Attach CDB operation input
-
object RollbackDetails
Rollback operation input
-
object RollbackPdbDetails
Rollback of PDBs operation input
-
object RollbackListenerDetails
Rollback of listerner operation input
-
object CleanupDetails
Cleanup operation input
-
object CleanupCdbDetails
Cleanup CDB operation input
-
object DeployExadataDetails
Deploy Exadata details
-
object UpdateExadataDetails
Update Exadata details
-
object RollbackExadataDetails
Rollback Exadata details
Nested Schema : DeployDetails
Type:
objectDeploy operation input
Show Source
-
deploy: object
deploy
Deploy operation input
Nested Schema : AttachCdbDetails
Type:
objectAttach CDB operation input
Show Source
-
attachCdb:
attachCdb
Attach CDB input
Nested Schema : DeployCdbDetails
Type:
objectDeploy CDB operation input
Show Source
-
deployCdb:
deployCdb
Deploy CDB operation input
Nested Schema : EmergencyDeployDetails
Type:
objectEmergency deploy operation input
Show Source
-
emergencyDeploy:
emergencyDeploy
Emergency deploy operation input
Nested Schema : MigrateListenerDetails
Type:
objectMigrate listener operation input
Show Source
-
migrateListener:
migrateListener
Migrate listener operation input
Nested Schema : UpdatePdbDetails
Type:
objectUpdate PDB operation input
Show Source
-
updatePdb:
updatePdb
Update operation input
Nested Schema : UpgradePdbDetails
Type:
objectUpgrade PDB operation input
Show Source
-
upgradePdb:
upgradePdb
Upgrade PDB operation input
Nested Schema : RollbackPdbDetails
Type:
objectRollback of PDBs operation input
Show Source
-
rollbackPdb:
rollbackPdb
Rollback of PDBs operation input
Nested Schema : RollbackListenerDetails
Type:
objectRollback of listerner operation input
Show Source
-
rollbackListener:
rollbackListener
Rollback of listener operation input
Nested Schema : CleanupCdbDetails
Type:
objectCleanup CDB operation input
Show Source
-
cleanupCdb:
cleanupCdb
Cleanup CDB operation input
Nested Schema : DeployExadataDetails
Type:
objectDeploy Exadata details
Show Source
-
deployExadata:
deployExadata
Deploy Exadata operation input
Nested Schema : UpdateExadataDetails
Type:
objectUpdate Exadata details
Show Source
-
updateExadata:
updateExadata
Update Exadata operation input
Nested Schema : RollbackExadataDetails
Type:
objectRollback Exadata details
Show Source
-
rollbackExadata:
rollbackExadata
Rollback Exadata operation input
Nested Schema : deploy
Type:
objectDeploy operation input
Match All
Deploy operation input
Show Source
-
object
allOf
DeployOperationInput
Input for 'deploy Oracle home' operation
Nested Schema : DeployOperationInput
Type:
objectInput for 'deploy Oracle home' operation
Show Source
-
additionalParam: string
Additional parameters for database deploymentExample:
-J-Xint -
attachHome: string
Param to indicate attach home
-
customCVUComponent: string
Custom CVU component
-
dispatcherLocation: string
Dispatcher locationExample:
/scratch/user/dispatchLoc -
externalStageLocation: string
External stage location of the imageExample:
/scratch/sharedLoc/san_loc -
gimrOsBackupDbaGroup: string
Mandatory OsBackupDba (GIMR only) group for target deployment
-
gimrOsDbaGroup: string
Mandatory OsDba (GIMR only) group for target deployment
-
gimrOsDgDbaGroup: string
Mandatory OsDgDba (GIMR only) group for target deployment
-
gimrOsInstallGroup: string
Mandatory OsInstall (GIMR only) group for target deployment
-
gimrOsKmDbaGroup: string
Mandatory OsKmDba (GIMR only) group for target deployment
-
gimrOsOperGroup: string
Mandatory OsOper (GIMR only) group for target deployment
-
gimrOsRacDbaGroup: string
Mandatory OsRacDba (GIMR only) group for target deployment
-
homeNamePrefix: string
Oracle Home Name Prefix for Deploy OperationExample:
OraPrefixHomeDb -
isBuiltInAccount: boolean
Default Value:
falseFlag to indicate built in account -
isForce: boolean
Default Value:
falseWhen set to true this flag forces Oracle Home cleanup even if there are potential conflicts, like a break within the lineage, with the databases contained within. In its default value of false, should conflicts arise when performing Oracle Home cleanup, the process stops and you see a warning message. -
isPrerequisitesOnly: boolean
Default Value:
falseFlag to indicate only prerequisite checks are to be performed -
isRedeploy: boolean
Default Value:
falseParam to indicate redeploy home -
isRootPreStaged: boolean
Default Value:
falseFlag to indicate root pre staged -
isRunCVUFromOH: boolean
Default Value:
falseFlag to indicate run CVU from Oracle home -
isSkipCVUChecks: boolean
Default Value:
falseFlag to indicate skipping CVU checks -
isSkipPrerequisites: boolean
Default Value:
falseFlag to indicate skipping prerequisites -
isSkipRemoteHostValidations: boolean
Default Value:
falseFlag to indicate skipping remote host validations -
isSkipValidations: boolean
Default Value:
falseFlag to indicate skipping validations -
isSkipWindowsHomeAccountTypeCheck: boolean
Default Value:
falseFlag to indicate skipping the Windows home account type check -
isStandByAutoDeploy: boolean
Default Value:
trueFlag to indicate auto deployment on the standby databases -
isVirtualAccount: boolean
Default Value:
falseFlag to indicate virtual account -
newOracleHomeLocation(required): string
New Oracle home locationExample:
/scratch/user/oraclehome -
normalCredential(required): string
Normal credentialExample:
HOST_CRED:ADMIN -
privilegeCredential: string
Privilege credentialExample:
HOST_ROOT_CRED:ADMIN -
targetData: array
targetData
Heterogenous list of targets
-
windowsSecurityCredential: string
Windows security credentialExample:
WIN_SEC_CRED:ADMIN -
workingDirectory: string
Working directoryExample:
/scratch/user/workDir
Match All
Input for 'deploy Oracle home' operation
Input for 'deploy Oracle home' operation
Show Source
-
object
TargetList
List of targets
-
object
OperationInput
Common Input for operations
Match One Schema
Show Source
Nested Schema : TargetList
Type:
objectList of targets
Show Source
-
targetList: array
targetList
Array of target names
-
targetType: string
Target typeExample:
oracle_database
Nested Schema : OperationInput
Type:
objectCommon Input for operations
Show Source
-
customPostScriptURN: string
Custom post script URN
-
customPreScriptURN: string
Custom pre script URN
-
deploymentProcedureNamePrefix: string
Deployment procedure name prefix
-
description: string
Description of the operation
-
fppOptions: object
fppOptions
Additional Properties Allowed:
trueAdditional key, value inputs for FPP operations -
fppRestUser: string
REST user to be used for an FPP REST callExample:
rest_cuser -
isRunPostScriptAsRoot: boolean
Default Value:
falseRuns post script as root -
isRunPreScriptAsRoot: boolean
Default Value:
falseRuns pre script as root -
metadataCheckCorrection: string
Default Value:
ignorePerforms metadata check correction -
name: string
Name of the operation
-
schedule: object
Schedule
This represents a schedule object to schedule blackouts.
Nested Schema : targetList
Type:
arrayArray of target names
Show Source
-
Array of:
string
Example:
db1, db2
Nested Schema : fppOptions
Type:
objectAdditional Properties Allowed:
trueAdditional key, value inputs for FPP operations
Nested Schema : Schedule
Type:
objectThis represents a schedule object to schedule blackouts.
Show Source
-
repeat: object
Repeat
Describes repetition of a blackout.
-
timeToStart: string
Start time of the blackout with timezone. Timestamps are with minute accuracy. Timezones can be given as offset (+01:00) or as zone (Europe/Berlin).Example:
2023-08-24T14:54-02:00
Match One Schema
Show Source
Nested Schema : Repeat
Type:
objectDescribes repetition of a blackout.
Show Source
-
timeToEndRepeat: string
End time of the repetition with timezone. Timestamps are with minute accuracy.Example:
2023-08-24T14:54-02:00
Match One Schema
Show Source
-
object
DaysOfYear
List of days of year.
-
object
DaysOfMonth
List of days of month in range 1-31 or -1 for last day of the month.
-
object
DaysOfWeek
List of days of week.
-
object
EveryNWeeks
Repeat every n weeks.
-
object
EveryNDays
Repeat every n days.
-
object
EveryNHours
Repeat every n hours.
-
object
EveryNMinutes
Repeat every n minutes, minimal value is 2.
Nested Schema : TimeToEnd
Type:
objectAn object specifying an end time with timezone. Timestamps are with minute accuracy. Timezones can be given as offset (+01:00) or as zone (Europe/Berlin).
Show Source
-
timeToEnd(required): string
An end timeExample:
2023-08-23T14:54+01:00
Nested Schema : Duration
Type:
objectA duration given in hours and minutes. At least one of durationHours and durationMinutes is required.
Show Source
-
durationHours: integer
Duration of the blackout in hours.Example:
2 -
durationMinutes: integer
Duration of the blackout in minutes.Example:
25
Nested Schema : DaysOfYear
Type:
objectList of days of year.
Show Source
-
daysOfYear: array
daysOfYear
List of days of the year.
Nested Schema : DaysOfMonth
Type:
objectList of days of month in range 1-31 or -1 for last day of the month.
Show Source
-
daysOfMonth: array
daysOfMonth
List of days of the month (1 based).
Nested Schema : DaysOfWeek
Type:
objectList of days of week.
Show Source
-
daysOfWeek: array
daysOfWeek
List of days of week (localized short names).
Nested Schema : EveryNWeeks
Type:
objectRepeat every n weeks.
Show Source
-
everyNWeeks: integer
Repeat interval in weeks.Example:
2
Nested Schema : EveryNDays
Type:
objectRepeat every n days.
Show Source
-
everyNDays: integer
Repeat interval in days, minimal value is 1.Example:
5
Nested Schema : EveryNHours
Type:
objectRepeat every n hours.
Show Source
-
everyNHours: integer
Repeat interval in hours.Example:
2
Nested Schema : EveryNMinutes
Type:
objectRepeat every n minutes, minimal value is 2.
Show Source
-
everyNMinutes: integer
Repeat interval in minutes.Example:
45
Nested Schema : items
Type:
Show Source
object-
day: integer
Day in range 1-31 or -1 for last day of the month.
-
month: integer
Month in range of 1-12.
Nested Schema : daysOfMonth
Type:
arrayList of days of the month (1 based).
Show Source
Example:
[
"1",
"15"
]Nested Schema : daysOfWeek
Type:
arrayList of days of week (localized short names).
Show Source
-
Array of:
string
Allowed Values:
[ "MO", "TU", "WE", "TH", "FR", "SA", "SU" ]
Example:
[
"MO",
"TH"
]Nested Schema : attachCdb
Attach CDB input
Match All
Attach CDB input
Show Source
-
object
allOf
AttachCdbOperationInput
Input for the 'attach CDB' operation
Nested Schema : AttachCdbOperationInput
Type:
objectInput for the 'attach CDB' operation
Show Source
-
targetData: array
targetData
Target data for the 'attach CDB' operation
Match All
Input for the 'attach CDB' operation
Show Source
-
object
allOf
PdbPatchingInput
PDB patching operation common details
Match One Schema
Show Source
Nested Schema : PdbPatchingInput
Type:
objectPDB patching operation common details
Show Source
-
databaseCredential: string
Database credentialExample:
DB_CRED:ADMIN -
databaseName: string
Name of the databaseExample:
pdb1 -
databasePrefix: string
Prefix of the database nameExample:
pdb -
destinationCdb: string
Destination CDBExample:
sales_cdb -
destinationOracleHomeLocation: string
Destination Oracle home locationExample:
/scratch/user/oraclehome -
destinationPrefix: string
Prefix of destination CDBExample:
sales -
isForce: string
Flag used in emergency patchingExample:
true -
isPrerequisitesOnly: boolean
Default Value:
falseFlag to indicate only prerequisite checks are to be performed -
isSkipRemoteHostValidations: boolean
Default Value:
falseFlag to indicate skipping the remote host validations -
isSkipValidations: string
Flag to indicate skipping validationsExample:
true -
normalCredential: string
Normal credentialExample:
HOST_CRED:ADMIN -
privilegeCredential: string
Privilege credentialExample:
HOST_ROOT_CRED:ADMIN -
workingDirectory: string
Working directoryExample:
/u01/scratch/workDir
Match All
PDB patching operation common details
PDB patching operation common details
Show Source
-
object
TargetList
List of targets
-
object
OperationInput
Common Input for operations
Match One Schema
Show Source
Nested Schema : deployCdb
Deploy CDB operation input
Match All
Deploy CDB operation input
Show Source
-
object
allOf
DeployCdbOperationInput
Input for the CDB deployment operation
Nested Schema : DeployCdbOperationInput
Type:
objectInput for the CDB deployment operation
Show Source
-
targetData: array
targetData
Target data for the 'deploy CDB' operation
Match All
Input for the CDB deployment operation
Show Source
-
object
allOf
PdbPatchingInput
PDB patching operation common details
Match One Schema
Show Source
Nested Schema : emergencyDeploy
Emergency deploy operation input
Match All
Emergency deploy operation input
Show Source
-
object
allOf
EmergencyDeployOperationInput
Input for emergency deploy operation
Nested Schema : EmergencyDeployOperationInput
Type:
objectInput for emergency deploy operation
Show Source
-
description: string
Description of the operationExample:
emergency deploy -
dispatcherLocation: string
Dispatcher locationExample:
/scratch/user/dispatchLoc -
isPrerequisitesOnly: boolean
Default Value:
falseFlag for prerequisites only -
isSkipCVUChecks: boolean
Default Value:
falseFlag to indicate skipping the CVU checks -
isSkipPrerequisites: boolean
Default Value:
falseFlag to indicate skipping prerequisite checks -
isSkipRemoteHostValidations: boolean
Default Value:
falseFlag to skip remote host validations -
isStandByAutoDeploy: boolean
Default Value:
trueFlag to indicate a deploy operation on standby databases -
metadataCheckCorrection: string
Flag for metadata check correction
-
name: string
Nmae of the operationExample:
emergency deploy -
newOracleHomeLocation(required): string
Path for the new Oracle Home
-
normalCredential: string
Normal credentialExample:
HOST_CRED:ADMIN -
patchList(required): array
patchList
List of patches to be applied
-
privilegeCredential: string
Privilege credentialExample:
HOST_ROOT_CRED:ADMIN -
targetName(required): string
Name of the target to be patchedExample:
salesdb -
targetType(required): string
Target typeExample:
oracle_database -
workingDirectory: string
Working directoryExample:
/scratch/user/workDir
Match All
Input for emergency deploy operation
Show Source
Nested Schema : migrateListener
Migrate listener operation input
Match All
Migrate listener operation input
Show Source
-
object
allOf
MigrateListenerOperationInput
Input for migrate listener operation
Nested Schema : MigrateListenerOperationInput
Type:
objectInput for migrate listener operation
Show Source
-
deploymentProcedureNamePrefix: string
Deployment procedure name prefix
-
description: string
Description of the operation
-
isForce: boolean
Default Value:
falseWhen set to true this flag forces Oracle Home cleanup to occur even if there are potential conflicts, like a break within the lineage, with the databases contained within. In its default value of false, should conflicts arise when performing Oracle Home cleanup, the process stops and you see a warning message -
isPrerequisitesOnly: boolean
Default Value:
falseFlag to indicate only prerequisite checks are to be performed -
isSkipRemoteHostValidations: boolean
Default Value:
falseFlag to indicate skipping the remote host validations -
isSkipValidations: boolean
Default Value:
falseFlag to indicate skipping validations -
isSkipWindowsHomeAccountTypeCheck: boolean
Default Value:
falseFlag to indicate skip Windows home account type check -
metadataCheckCorrection: string
Default Value:
ignorePerforms metadata check correction -
name(required): string
Name of the operation
-
newOracleHomeLocation: string
New Oracle home locationExample:
/scratch/user/oraclehome -
normalCredential: string
Normal credentialExample:
HOST_CRED:ADMIN -
privilegeCredential: string
Privilege credentialExample:
HOST_ROOT_CRED:ADMIN -
schedule: object
Schedule
This represents a schedule object to schedule blackouts.
-
windowsSecurityCredential: string
Windows security credentialExample:
WIN_SEC_CRED:ADMIN -
workingDirectory: string
Working directoryExample:
/scratch/user/workDir
Match All
Input for migrate listener operation
Show Source
-
object
TargetList
List of targets
Nested Schema : update
Update operation input
Match All
Update operation input
Show Source
-
object
allOf
UpdateOperationInput
Input for the update operation
Nested Schema : UpdateOperationInput
Type:
objectInput for the update operation
Match All
Input for the update operation
Input for the update operation
Input for the update operation
Show Source
-
object
OperationInput
Common Input for operations
-
object
TargetList
List of targets
-
object
allOf
UpdateDBOperationInput
Input for the update database operation
Nested Schema : UpdateDBOperationInput
Type:
objectInput for the update database operation
Show Source
-
auto: string
Auto parameter
-
blackoutId: string
ID of the black out
-
cleanpids: string
Clean PIDs
-
databaseList: string
Database list
-
databaseToPdbData: array
databaseToPdbData
Input to convert the database to PDB
-
dataFileLocation: string
Custom location for data files. File System and Automatic Storage Management (ASM) formats are supported
-
dataguardRole: string
Enum for Data Guard role
-
deleteSourceDatabase: string
Indicates if the source database can be deleted
-
description: string
Description of the update operation
-
destinationCdbCredential: string
Destination CDB credentialExample:
HOST_CDB_CRED:ADMIN -
destinationHostCredential: string
Destination host credentialExample:
HOST_CRED:ADMIN -
destinationPdbDisplayName: string
Destination PDB name
-
destinationPdbName: string
Destination PDB nameExample:
hrpdb -
destinationWalletPassword: string
Destination database wallet password, only for TDE enabled databases
-
destinationWorkingDirectory: string
Working directory in the destination host
-
disconnect: string
Disconnect parameter
-
dispatcherLocation: string
Dispatcher locationExample:
/scratch/user/dispatchLoc -
drainTimeout: string
Drain time out
-
excludeDatabaseList: string
Exclude database list parameter
-
fppOptions: object
fppOptions
Additional Properties Allowed:
trueAdditional key, value inputs for FPP operations -
gimrOperation: string
Identifies the Grid Infrastructure Management Repository (GIMR) operation
-
ignoreDatabaseStartError: string
Ignore database start error parameter
-
isBuiltinAccount: boolean
Built in account, only for Windows deployments
-
isDisableDataguard: boolean
Default Value:
falseFlag to indicate the operation to disable Data Guard role -
isEnableDataguard: boolean
Default Value:
falseFlag to indicate the operation to enable Data Guard role -
isEnableFSFO: boolean
Default Value:
falseFlag to indicate the operation to enable FSFO -
isForce: boolean
Forces the execution
-
isIgnoreStandbyPrerequisites: boolean
Default Value:
falseThis disables the verification check if the standby is on same image version that the primary is being moved to -
isNonCdbToPdb: boolean
Flag to identify non CDB to PDB operation
-
isPrerequisitesOnly: boolean
Default Value:
falseFlag to indicate only prerequisite checks are to be performed -
isRolling: boolean
Default Value:
falseFlag to indicate a rolling patch operation -
isSkipCVUChecks: boolean
Default Value:
falseFlag to indicate skipping the CVU checks -
isSkipLocalSaveState: boolean
Skip local state saving
-
isSkipPrerequisites: boolean
Default Value:
falseFlag to indicate skipping the prerequisite checks -
isSkipRemoteHostValidations: boolean
Default Value:
falseFlag to indicate skipping remote host validations -
isSkipSwitchDatabase: boolean
It should be set to true. It skips switching of the database to the patched home since it is already performed in earlier steps.
-
isSkipValidations: boolean
Default Value:
falseFlag to indicate skipping the validations -
isSkipWindowsHomeAccountTypeCheck: boolean
Skip the Windows home account type check
-
isStartupAfterSwitch: boolean
For non-rolling patches, it is necessary to bring up the Primary database first from the patched home. It will ensure that the standby is left in the shutdown state during the update operation. The standby database will be started in a separate step after the primary is patched and started.
-
isStartupDatabase: boolean
Startup the database after the patch is completed
-
isStartupDBAfterSwitch: boolean
Default Value:
trueIt is used for node-wise patching in order to leave a database instance down after a cluster instance is patched -
isVirtualAccount: boolean
Virtual account, only for Windows deployments
-
migrateDatabase: string
Indicates the migrate database operation
-
migrateType: string
Enum for migrate type
-
newOracleHomeLocation: string
Path for the new Oracle Home
-
nodeList: string
comma separated list of nodes
-
normalCredential: string
Normal credentialExample:
HOST_CRED:ADMIN -
parallelism: string
Parallelism parameterExample:
4 -
pdbAdminName: string
PDB admin name
-
primaryDatabaseHostCredential: string
Host credential for the primary database
-
privilegeCredential: string
Privilege credentialExample:
HOST_ROOT_CRED:ADMIN -
sourceWalletPassword: string
Source database wallet password, only for TDE enabled databases
-
sourceWorkingDirectory: string
Working directory on source databaseExample:
/scratch/user/workdir -
sqlSequence: string
SQL sequence
-
standbyStartOption: string
Standby start up option after the patch
-
startupStandby: string
Startup standby
-
targetNode: string
Target node
-
templateName: string
Custom database template path in software library
-
windowsCredential: string
Windows credential, only for Windows deployments
-
windowsSecurityCredential: string
Windows security credentialExample:
WIN_SEC_CRED:ADMIN -
workingDirectory: string
Working directoryExample:
/scratch/user/workDir
Match All
Input for the update database operation
Input for the update database operation
Show Source
-
object
OperationInput
Common Input for operations
-
object
TargetList
List of targets
Nested Schema : updatePdb
Update operation input
Match All
Update operation input
Show Source
-
object
allOf
UpdatePdbOperationInput
Input for the 'update PDB' operation
Nested Schema : UpdatePdbOperationInput
Type:
objectInput for the 'update PDB' operation
Show Source
-
destinationCdbName: string
Destination CDB nameExample:
sales_cdb
Match All
Input for the 'update PDB' operation
Show Source
-
object
allOf
PdbPatchingInput
PDB patching operation common details
Nested Schema : upgrade
Upgrade operation input
Match All
Upgrade operation input
Show Source
-
object
allOf
UpgradeOperationInput
Details for Upgrade operation
Nested Schema : UpgradeOperationInput
Type:
objectDetails for Upgrade operation
Show Source
-
autoUpgradeAdditionalInput: object
AutoUpgradeAdditionalInput
Additional input for upgrade using auto upgrade tool.
Match All
Details for Upgrade operation
Show Source
-
object
allOf
UpdateOperationInput
Input for the update operation
Nested Schema : upgradePdb
Upgrade PDB operation input
Match All
Upgrade PDB operation input
Show Source
-
object
allOf
PdbPatchingInput
PDB patching operation common details
Nested Schema : rollback
Rollback operation input
Match All
Rollback operation input
Show Source
-
object
allOf
RollbackOperationInput
Input to create rollback to old Oracle home
Nested Schema : RollbackOperationInput
Type:
objectInput to create rollback to old Oracle home
Show Source
-
isdowngradeOperation: boolean
It should be set to true for downgrade GI / SIHA operations.
-
isReportOnly: boolean
Default Value:
falseFlag indicates report only -
targetName(required): string
Name of the targetExample:
db1
Match All
Input to create rollback to old Oracle home
Show Source
-
object
allOf
DeployOperationInput
Input for 'deploy Oracle home' operation
Nested Schema : rollbackPdb
Rollback of PDBs operation input
Match All
Rollback of PDBs operation input
Show Source
-
object
allOf
RollbackPdbOperationInput
Rollback PDB details
Nested Schema : RollbackPdbOperationInput
Type:
objectRollback PDB details
Show Source
-
isReportOnly: boolean
Default Value:
falseFlag indicates report only
Match All
Rollback PDB details
Show Source
-
object
allOf
PdbPatchingInput
PDB patching operation common details
Nested Schema : rollbackListener
Rollback of listener operation input
Match All
Rollback of listener operation input
Show Source
-
object
allOf
MigrateListenerOperationInput
Input for migrate listener operation
Nested Schema : cleanup
Cleanup operation input
Match All
Cleanup operation input
Show Source
-
object
allOf
CleanupOperationInput
Input to cleanup old Oracle home
Nested Schema : CleanupOperationInput
Type:
objectInput to cleanup old Oracle home
Show Source
-
databaseCredential: string
Database credentialExample:
DB_CRED:ADMIN -
description: string
Description of the operationExample:
Clean up database homes -
dispatcherLocation: string
Location of dispatcherExample:
/scratch/user/dispatcherLoc -
fppOptions: object
fppOptions
Additional Properties Allowed:
trueAdditional key, value inputs for FPP operations -
isForce: boolean
Default Value:
falseWhen set to true this flag forces an Oracle Home cleanup to occur even if there are potential conflicts, like a break within the lineage, with the databases contained within. In its default value of false, should conflicts arise when performing Oracle Home cleanup, the process stops and you see a warning message in the EM CLI console. -
isReportOnly: boolean
Default Value:
falseFlag indicates report only -
normalCredential: string
Normal credentialExample:
HOST_CRED:ADMIN -
privilegeCredential: string
Privilege credentialExample:
HOST_ROOT_CRED:ADMIN -
workingDirectory(required): string
Working directoryExample:
/scratch/user/workDir
Match All
Input to cleanup old Oracle home
Input to cleanup old Oracle home
Show Source
-
object
OperationInput
Common Input for operations
-
object
TargetList
List of targets
Nested Schema : cleanupCdb
Cleanup CDB operation input
Match All
Cleanup CDB operation input
Show Source
-
object
allOf
CleanupCdbOperationInput
Input for cleanup of CDB and oracle homes
Nested Schema : CleanupCdbOperationInput
Type:
objectInput for cleanup of CDB and oracle homes
Match All
Input for cleanup of CDB and oracle homes
Show Source
-
object
allOf
CleanupOperationInput
Input to cleanup old Oracle home
Nested Schema : deployExadata
Deploy Exadata operation input
Match All
Deploy Exadata operation input
Show Source
-
object
allOf
DeployExadataInput
Request to Deploy Exadata Software
Nested Schema : DeployExadataInput
Type:
objectRequest to Deploy Exadata Software
Show Source
-
patchExtractLocation(required): string
Location, where patch will be extracted on exadata client.Example:
/u01/scratch/images/imageName
Match All
Request to Deploy Exadata Software
Show Source
-
object
allOf
ExadataPatchingInput
Common input parameters for Exadata operations.
Nested Schema : ExadataPatchingInput
Type:
objectCommon input parameters for Exadata operations.
Show Source
-
description: string
Description of the operation.
-
fppOptions: object
fppOptions
Additional key, value inputs for FPP operations
-
fppRestUser: string
Rest user to be used for FPP rest callExample:
rest_cuser -
isPrerequisitesOnly: boolean
Default Value:
falseFlag to indicate only prerequisite checks -
isSkipRemoteHostValidations: boolean
Default Value:
falseFlag to indicate skip the remote host validations -
isSkipValidations: boolean
Default Value:
falseFlag to indicate skipping the validations -
name(required): string
Custom name to identify this deployment operation.
-
normalCredential: string
Normal credentialExample:
HOST_CRED:SYSMAN -
schedule: object
Schedule
This represents a schedule object to schedule blackouts.
-
targetType(required): string
Type of the TargetExample:
[ "oracle_si_netswitch", "oracle_dbmachine", "oracle_exadata", "host" ] -
workingDirectory(required): string
Working directory, where temporary files will be stored.Example:
/scratch/user/workDir
Match All
Common input parameters for Exadata operations.
Show Source
-
object
TargetList
List of targets
Nested Schema : updateExadata
Update Exadata operation input
Match All
Update Exadata operation input
Show Source
-
object
allOf
UpdateExadataInput
Request to Update Exadata Software
Nested Schema : UpdateExadataInput
Type:
objectRequest to Update Exadata Software
Show Source
-
targetOverrides: object
targetOverrides
Additional key, value inputs for Target Overrides. This attribute is used to populate Exadata node names without fqdn. User can use this attribute to pass the actual node names of Exadata.
Match All
Request to Update Exadata Software
Show Source
-
object
allOf
ExadataPatchingInput
Common input parameters for Exadata operations.
Nested Schema : rollbackExadata
Rollback Exadata operation input
Match All
Rollback Exadata operation input
Show Source
-
object
allOf
RollbackExadataInput
Request to Rollback Exadata Software
Nested Schema : RollbackExadataInput
Type:
objectRequest to Rollback Exadata Software
Show Source
-
targetOverrides: object
targetOverrides
Additional key, value inputs for Target Overrides. This attribute is used to populate Exadata node names without fqdn. User can use this attribute to pass the actual node names of Exadata.
Match All
Request to Rollback Exadata Software
Show Source
-
object
allOf
ExadataPatchingInput
Common input parameters for Exadata operations.
Examples
Back to Top
Response
Supported Media Types
- application/json
202 Response
Accepted. Fleet operation(s) is(are) submitted.
Root Schema : FleetOperationsResult
Type:
objectResponse of fleet operations
Match Any
Show Source
-
object DeployOperationSubmission
Deploy submission details
-
object EmergencyDeployOperationSubmission
Emergency deploy submission details
-
object DeployCdbSubmission
Deploy CDB submission details
-
object AttachCdbSubmission
Attach CDB submission details
-
object UpdateSubmission
Update submission details
-
object UpdatePdbSubmission
Update PDB submission details
-
object UpgradeSubmission
Upgrade submission details
-
object UpgradePdbSubmission
Upgrade PDB submission details
-
object MigrateListenerSubmission
Migrate listener submission details
-
object RollbackSubmission
Rollback submission details
-
object RollbackPdbSubmission
Rollback PDB submission details
-
object RollbackListenerSubmission
Rollback listener submission details
-
object CleanupSubmission
Cleanup submission details
-
object CleanupCdbSubmission
Cleanup CDB submission details
-
object DeployExadataSubmission
Deploy Exadata submission details
-
object UpdateExadataSubmission
Update Exadata submission details
-
object RollbackExadataSubmission
Rollback Exadata submission details
Nested Schema : DeployOperationSubmission
Type:
objectDeploy submission details
Show Source
-
deployDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : EmergencyDeployOperationSubmission
Type:
objectEmergency deploy submission details
Show Source
-
emergencyDeployDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : DeployCdbSubmission
Type:
objectDeploy CDB submission details
Show Source
-
deployCdbDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : AttachCdbSubmission
Type:
objectAttach CDB submission details
Show Source
-
attachCdbDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : UpdateSubmission
Type:
objectUpdate submission details
Show Source
-
updateDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : UpdatePdbSubmission
Type:
objectUpdate PDB submission details
Show Source
-
updatePdbDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : UpgradeSubmission
Type:
objectUpgrade submission details
Show Source
-
upgradeDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : UpgradePdbSubmission
Type:
objectUpgrade PDB submission details
Show Source
-
upgradePdbDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : MigrateListenerSubmission
Type:
objectMigrate listener submission details
Show Source
-
migratelistenerDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : RollbackSubmission
Type:
objectRollback submission details
Show Source
-
rollbackDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : RollbackPdbSubmission
Type:
objectRollback PDB submission details
Show Source
-
rollbackPdbDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : RollbackListenerSubmission
Type:
objectRollback listener submission details
Show Source
-
rollbackListenerDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : CleanupSubmission
Type:
objectCleanup submission details
Show Source
-
cleanupDetails: object
CleanupOperationResult
Cleanup operation response. Fleet operation validations are not applicable for cleanup and cleanup CDB. Hence validations are not be available under 'submissions'.
Nested Schema : CleanupCdbSubmission
Type:
objectCleanup CDB submission details
Show Source
-
cleanupCdbDetails: object
CleanUpCdbAndHomesOperationResultCollection
Response for cleanup CDB and Oracle Homes operation
Nested Schema : DeployExadataSubmission
Type:
objectDeploy Exadata submission details
Show Source
-
deployExadataDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : UpdateExadataSubmission
Type:
objectUpdate Exadata submission details
Show Source
-
updateExadataDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : RollbackExadataSubmission
Type:
objectRollback Exadata submission details
Show Source
-
rollbackExadataDetails: object
FleetOperation
Response for the fleet operation
Nested Schema : FleetOperation
Type:
objectResponse for the fleet operation
Show Source
-
isPrerequisitesOnly: boolean
Default Value:
falseIndicates if the operation is a prerequisites -
targetSubmissions: array
targetSubmissions
Array of submissions for Targets
Nested Schema : targetSubmissions
Type:
arrayArray of submissions for Targets
Show Source
-
Array of:
object TargetSubmissions
Array of submissions for targets
Nested Schema : TargetSubmissions
Type:
objectArray of submissions for targets
Show Source
-
status: string
Enum for status
-
submissions: array
submissions
Submissions of operation for the target
Match All
Array of submissions for targets
Show Source
-
object
TargetList
List of targets
Nested Schema : submissions
Type:
arraySubmissions of operation for the target
Show Source
-
Array of:
object Submission
Submission summary of target for an operation
Nested Schema : TargetList
Type:
objectList of targets
Show Source
-
targetList: array
targetList
Array of target names
-
targetType: string
Target typeExample:
oracle_database
Nested Schema : Submission
Type:
objectSubmission summary of target for an operation
Show Source
-
messages: string
Messages of submission
Match All
Submission summary of target for an operation
Show Source
-
object
TargetList
List of targets
Match Any
Show Source
-
object TargetValidation
Fleet operation target validation results
-
object SubmissionError
Submission error details
Nested Schema : TargetValidation
Type:
objectFleet operation target validation results
Show Source
-
links: object
links
Links of procedure execution and tracking
-
status: string
Enum for status
-
validations: array
validations
Array of validation results
Match All
Fleet operation target validation results
Show Source
-
object
ValidationSummary
Validation result summary
Nested Schema : SubmissionError
Type:
objectSubmission error details
Show Source
-
errorMessages: string
Error message for the failed submission
-
status: string
Status of the submission
Nested Schema : targetList
Type:
arrayArray of target names
Show Source
-
Array of:
string
Example:
db1, db2
Nested Schema : links
Type:
objectLinks of procedure execution and tracking
Match All
Links of procedure execution and tracking
Links of procedure execution and tracking
Show Source
-
object
ProcedureLink
Represents a link to the deployment procedure execution
-
object
TrackingLink
Represents a link to the REST API to track status
Nested Schema : validations
Type:
arrayArray of validation results
Show Source
-
Array of:
object Validation
Validation details
Nested Schema : ValidationSummary
Type:
objectValidation result summary
Show Source
-
failed: integer
Total count of failed validationsExample:
0 -
submitted: integer
0 Indicates the deployment procedure for the validation is not submitted, 1 indicates the deployment procedure for the validation is submittedExample:
0 -
succeeded: integer
Total count of succeeded validationsExample:
8 -
totalValidations: integer
Total count of validationsExample:
8 -
warnings: integer
Total count of warningsExample:
0
Nested Schema : ProcedureLink
Type:
objectRepresents a link to the deployment procedure execution
Show Source
-
procedureExecution: object
procedureExecution
Web URL to poll status of the deployment procedure execution
Nested Schema : TrackingLink
Type:
objectRepresents a link to the REST API to track status
Show Source
-
tracking: object
tracking
Tracking URL to poll status of the deployment procedure execution
Nested Schema : procedureExecution
Type:
objectWeb URL to poll status of the deployment procedure execution
Show Source
-
href: string
URL for linkExample:
https://myhost.com:portnumber/em/faces/core-jobs-procedureExecutionTracking?executionGUID=E6E32C11DC0A6E8DE05380FE4564A6B2
Nested Schema : tracking
Type:
objectTracking URL to poll status of the deployment procedure execution
Show Source
-
href: string
URL for the linkExample:
/deploymentProcedureInstances/{deploymentProcedureInstanceId}
Nested Schema : Validation
Type:
objectValidation details
Show Source
-
description: string
Description of the validationExample:
Verfied that the EM user has "configure target" privileges on the target. -
id: string
ID of the validationExample:
CONFIG_TARGET_USER_PRIV_VALIDATION -
links: object
links
Links of procedure execution and tracking
-
name: string
Name of the validationExample:
Configure target privilege validation -
status: string
Enum for validation statusExample:
success
Nested Schema : links
Type:
objectLinks of procedure execution and tracking
Match All
Links of procedure execution and tracking
Links of procedure execution and tracking
Show Source
-
object
ProcedureLink
Represents a link to the deployment procedure execution
-
object
TrackingLink
Represents a link to the REST API to track status
Nested Schema : CleanupOperationResult
Type:
objectCleanup operation response. Fleet operation validations are not applicable for cleanup and cleanup CDB. Hence validations are not be available under 'submissions'.
Match All
Cleanup operation response. Fleet operation validations are not applicable for cleanup and cleanup CDB. Hence validations are not be available under 'submissions'.
Cleanup operation response. Fleet operation validations are not applicable for cleanup and cleanup CDB. Hence validations are not be available under 'submissions'.
Show Source
-
object
FleetOperation
Response for the fleet operation
-
object
CleanupReport
Response for CleanUp Oracle Home Operation
Nested Schema : CleanupReport
Type:
objectResponse for CleanUp Oracle Home Operation
Show Source
-
report: object
report
CleanUp Report
Nested Schema : report
Type:
objectCleanUp Report
Show Source
-
countEligibleOracleHomes: integer
Eligible Oracle Homes count
-
countIneligibleOracleHomes: integer
InEligible Oracle Homes count
-
eligibleOracleHomes: array
eligibleOracleHomes
Eligible Oracle Homes
-
ineligibleOracleHomes: array
ineligibleOracleHomes
InEligible Oracle Homes
-
message: string
Report related messageExample:
Report Generated Successfully
Nested Schema : eligibleOracleHomes
Type:
arrayEligible Oracle Homes
Show Source
-
Array of:
object OracleHomeDetails
Oracle Home details
Nested Schema : ineligibleOracleHomes
Type:
arrayInEligible Oracle Homes
Show Source
-
Array of:
object OracleHomeDetails
Oracle Home details
Nested Schema : OracleHomeDetails
Type:
objectOracle Home details
Show Source
-
countAssociatedTargets: integer
Associated targets count
-
homeLocation: string
Location of Oracle HomeExample:
/scratch/cuser/deployedHome -
hostName: string
Host of Oracle homeExample:
myhost.com -
targetName: string
Name of the targetExample:
db1
Nested Schema : CleanUpCdbAndHomesOperationResultCollection
Type:
objectResponse for cleanup CDB and Oracle Homes operation
Match All
Response for cleanup CDB and Oracle Homes operation
Response for cleanup CDB and Oracle Homes operation
Show Source
-
object
FleetOperation
Response for the fleet operation
-
object
CleanupCdbReport
Report for Cleanup CDB and Homes
Nested Schema : CleanupCdbReport
Type:
objectReport for Cleanup CDB and Homes
Show Source
-
report: object
report
Cleanup CDB Report
Nested Schema : report
Type:
objectCleanup CDB Report
Show Source
-
countEligibleCdbs: integer
Eligible CDBs count
-
countEligibleOracleHomes: integer
Eligible Oracle Homes count
-
countIneligibleCdbs: integer
Ineligible CDBs count
-
countIneligibleOracleHomes: integer
Ineligible Oracle Homes count
-
eligibleCdbs: array
eligibleCdbs
Eligible CDBs
-
eligibleOracleHomes: array
eligibleOracleHomes
Eligible Oracle Homes
-
ineligibleCdbs: array
ineligibleCdbs
Ineligible CDBs
-
ineligibleOracleHomes: array
ineligibleOracleHomes
InEligible Homes
-
message: string
Report related messageExample:
Report Generated Successfully
Nested Schema : eligibleCdbs
Type:
arrayEligible CDBs
Show Source
-
Array of:
object CdbDetails
CDB details
Nested Schema : eligibleOracleHomes
Type:
arrayEligible Oracle Homes
Show Source
-
Array of:
object OracleHomeDetails
Oracle Home details
Nested Schema : ineligibleCdbs
Type:
arrayIneligible CDBs
Show Source
-
Array of:
object CdbDetails
CDB details
Nested Schema : ineligibleOracleHomes
Type:
arrayInEligible Homes
Show Source
-
Array of:
object OracleHomeDetails
Oracle Home details
Nested Schema : CdbDetails
Type:
objectCDB details
Show Source
-
countAssociatedPdbs: integer
Associated PDBs count
-
hostName: string
Host of Oracle homeExample:
myhost.com -
id: string
ID of a CDB targetExample:
EF17D657C6AD7C1BE05375FD4564B913 -
name: string
Name of a CDBExample:
cdb1 -
oracleHomeLocation: string
Oracle home pathExample:
/scratch/cuser/deployedHome
Examples
400 Response
Bad Request. The payload is null or missing some parameters
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument -
message: string
A descriptive error message.Example:
argument given is not supported
401 Response
Unauthorized. The user does not have permissions to perform the requested operation
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument -
message: string
A descriptive error message.Example:
argument given is not supported
403 Response
Forbidden. The user is forbidden to perform the requested operation
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument -
message: string
A descriptive error message.Example:
argument given is not supported
404 Response
Not Found. The requested REST API URL is not found.
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument -
message: string
A descriptive error message.Example:
argument given is not supported
500 Response
Internal Server Error. Exception in execution of REST API.
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument -
message: string
A descriptive error message.Example:
argument given is not supported
503 Response
Service Unavailable. The server is unable to process the request.
Root Schema : ErrorResponse
Type:
objectResponse sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument -
message: string
A descriptive error message.Example:
argument given is not supported