Skip to main content

maintenance_run_history

Creates, updates, deletes, gets or lists a maintenance_run_history resource.

Overview​

Namemaintenance_run_history
TypeResource
Idoci.database.maintenance_run_history

Fields​

The following fields are returned by SELECT queries:

Details of a maintenance run history.

NameDatatypeDescription
idstringThe OCID of the maintenance run history.
dbServersHistoryDetailsarrayList of database server history details.
granularMaintenanceHistoryarrayThe list of granular maintenance history details.
maintenanceRunDetailsobjectDetails of a maintenance run.
systemTagsobjectSystem tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectcompartmentId, regiontargetResourceId, targetResourceType, maintenanceType, limit, page, sortBy, sortOrder, lifecycleState, availabilityDomain, maintenanceSubtypeGets a list of the maintenance run histories in the specified compartment.<br />

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
compartmentIdstringThe compartment [OCID](/Content/General/Concepts/identifiers.htm).
regionstringOCI region identifier (e.g. us-ashburn-1, ap-sydney-1); resolves from OCI_REGION when not supplied in the query. (default: us-ashburn-1, x-stackQL-envVar: OCI_REGION)
availabilityDomainstringA filter to return only resources that match the given availability domain exactly.
lifecycleStatestringThe state of the maintenance run history.
limitintegerThe maximum number of items to return per page.
maintenanceSubtypestringThe sub-type of the maintenance run.
maintenanceTypestringThe maintenance type.
pagestringThe pagination token to continue listing from.
sortBystringThe field to sort by. You can provide one sort order (sortOrder). Default order for TIME_SCHEDULED and TIME_ENDED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.
sortOrderstringThe sort order to use, either ascending (ASC) or descending (DESC).
targetResourceIdstringThe target resource ID.
targetResourceTypestringThe type of the target resource.

SELECT examples​

Gets a list of the maintenance run histories in the specified compartment.<br />

SELECT
id,
dbServersHistoryDetails,
granularMaintenanceHistory,
maintenanceRunDetails,
systemTags
FROM oci.database.maintenance_run_history
WHERE compartmentId = '{{ compartmentId }}' -- required
AND region = '{{ region }}' -- required
AND targetResourceId = '{{ targetResourceId }}'
AND targetResourceType = '{{ targetResourceType }}'
AND maintenanceType = '{{ maintenanceType }}'
AND limit = '{{ limit }}'
AND page = '{{ page }}'
AND sortBy = '{{ sortBy }}'
AND sortOrder = '{{ sortOrder }}'
AND lifecycleState = '{{ lifecycleState }}'
AND availabilityDomain = '{{ availabilityDomain }}'
AND maintenanceSubtype = '{{ maintenanceSubtype }}'
;