Summarize the AWR database parameter change history.
GET {{baseUrl}}/managedDatabases/:managedDatabaseId/awrDbs/:awrDbId/awrDbParameterChanges?instNum=<string>&beginSnIdGreaterThanOrEqualTo=<integer>&endSnIdLessThanOrEqualTo=<integer>&timeGreaterThanOrEqualTo=<dateTime>&timeLessThanOrEqualTo=<dateTime>&containerId=<integer>&name=<string>&page=<string>&limit=1000&sortBy=IS_CHANGED&sortOrder=DESC
Summarizes the database parameter change history for one database parameter of the specified database in AWR. One change history record contains the previous value, the changed value, and the corresponding time range. If the database parameter value was changed multiple times within the time range, then multiple change history records are created for the same parameter. Note that this API only returns information on change history details for one database parameter. To get a list of all the database parameters whose values were changed during a specified time range, use the following API endpoint: /managedDatabases/{managedDatabaseId}/awrDbs/{awrDbId}/awrDbParameters
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
instNum | string | The optional single value query parameter to filter the database instance number. | |
beginSnIdGreaterThanOrEqualTo | string | The optional greater than or equal to filter on the snapshot ID. | |
endSnIdLessThanOrEqualTo | string | The optional less than or equal to query parameter to filter the snapshot ID. | |
timeGreaterThanOrEqualTo | string | The optional greater than or equal to query parameter to filter the timestamp. | |
timeLessThanOrEqualTo | string | The optional less than or equal to query parameter to filter the timestamp. | |
containerId | string | The optional query parameter to filter the database container by an exact ID value. | |
Note that the database container ID can be retrieved from the following endpoint: | |||
/managedDatabases/{managedDatabaseId}/awrDbSnapshotRanges | |||
name | string | (Required) The required single value query parameter to filter the entity name. | |
page | string | The page token representing the page from where the next set of paginated results | |
are retrieved. This is usually retrieved from a previous list call. | |||
limit | number | The maximum number of records returned in large paginated response. | |
sortBy | string | The option to sort the AWR database parameter change history data. | |
sortOrder | string | The option to sort information in ascending (‘ASC’) or descending (‘DESC’) order. Descending order is the default order. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
opc-request-id | string | The client request ID for tracing. | |
opc-retry-token | string | A token that uniquely identifies a request so it can be retried in case of a timeout or | |
server error without risk of executing that same action again. Retry tokens expire after 24 | |||
hours, but can be invalidated before then due to conflicting operations. For example, if a resource | |||
has been deleted and purged from the system, then a retry of the original creation request | |||
might be rejected. | |||
opc-named-credential-id | string | The OCID of the Named Credential. | |
Accept | string |
RESPONSES
status: OK
{"name":"\u003cstring\u003e","awrResultType":"AWRDB_DB_PARAMETER_SET","dbQueryTimeInSecs":"\u003cdouble\u003e","queryKey":"\u003cstring\u003e","version":"\u003cstring\u003e","items":[{"snapshotId":"\u003cinteger\u003e","instanceNumber":"\u003cinteger\u003e","isDefault":"\u003cboolean\u003e","previousValue":"\u003cstring\u003e","timeBegin":"\u003cdateTime\u003e","timeEnd":"\u003cdateTime\u003e","value":"\u003cstring\u003e","valueModified":"\u003cstring\u003e"},{"snapshotId":"\u003cinteger\u003e","instanceNumber":"\u003cinteger\u003e","isDefault":"\u003cboolean\u003e","previousValue":"\u003cstring\u003e","timeBegin":"\u003cdateTime\u003e","timeEnd":"\u003cdateTime\u003e","value":"\u003cstring\u003e","valueModified":"\u003cstring\u003e"}]}