Start the discovery process for Exadata system infrastructure from the specified agent.
POST {{baseUrl}}/externalExadataInfrastructures/actions/discoverExadataInfrastructure
Completes the Exadata system prechecking on the following:
- Verifies if the DB systems are valid RAC DB systems or return 400 status code with NONRACDATABASE_SYSTEM error code.
- Verifies if the ASM connector defined for each DB system or return 400 status code with CONNECTORNOTDEFINED error code.
- Verifies if the agents associated with ASM are valid and could be used for the Exadata storage servers or return 400 status code with INVALID_AGENT error code.
- Verifies if it is an Exadata system or return 400 status code with INVALIDEXADATASYSTEM error code.
Starts the discovery process for the Exadata system infrastructure. The following resources/components are discovered
- Exadata storage servers from each DB systems
- Exadata storage grid for all Exadata storage servers
- Exadata infrastructure
The same API covers both new discovery and rediscovery cases. For the new discovery case, new managed resources/sub-resources are created or the existing ones are overridden. For rediscovery case, the existing managed resources/sub-resources are checked to find out which ones should be added or which ones should be removed based on the unique key defined for each resource/sub-resource.
Request Body
{"discoveryType"=>"NEW", "compartmentId"=>"<string>", "dbSystemIds"=>["<string>", "<string>"], "exadataInfrastructureId"=>"<string>"}
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. | |||
if-match | string | For optimistic concurrency control. In the PUT or DELETE call | |
for a resource, set the if-match parameter to the value of the | |||
| etag from a previous GET or POST response for that resource. | |||
| The resource will be updated or deleted only if the etag you | |||
| provide matches the resource's current etag value. | |||
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"discoveryKey":"\u003cstring\u003e","displayName":"\u003cstring\u003e","entityType":"STORAGE_SERVER_DISCOVER_SUMMARY","agentId":"\u003cstring\u003e","connectorId":"\u003cstring\u003e","discoverErrorCode":"\u003cstring\u003e","discoverErrorMsg":"\u003cstring\u003e","discoverStatus":"NEW_DISCOVERED","id":"\u003cstring\u003e","internalId":"\u003cstring\u003e","status":"\u003cstring\u003e","version":"\u003cstring\u003e","compartmentId":"\u003cstring\u003e","dbSystems":[{"displayName":"\u003cstring\u003e","entityType":"DATABASE_SYSTEM_DISCOVER_SUMMARY","agentId":"\u003cstring\u003e","connectorId":"\u003cstring\u003e","discoverErrorCode":"\u003cstring\u003e","discoverErrorMsg":"\u003cstring\u003e","discoverStatus":"NEW_DISCOVERED","id":"\u003cstring\u003e","internalId":"\u003cstring\u003e","status":"\u003cstring\u003e","version":"\u003cstring\u003e","asmConnectorName":"\u003cstring\u003e","compartmentId":"\u003cstring\u003e","licenseModel":"LICENSE_INCLUDED","oracleHome":"\u003cstring\u003e"},{"displayName":"\u003cstring\u003e","entityType":"STORAGE_GRID_DISCOVER_SUMMARY","agentId":"\u003cstring\u003e","connectorId":"\u003cstring\u003e","discoverErrorCode":"\u003cstring\u003e","discoverErrorMsg":"\u003cstring\u003e","discoverStatus":"NEW_DISCOVERED","id":"\u003cstring\u003e","internalId":"\u003cstring\u003e","status":"\u003cstring\u003e","version":"\u003cstring\u003e","asmConnectorName":"\u003cstring\u003e","compartmentId":"\u003cstring\u003e","licenseModel":"BRING_YOUR_OWN_LICENSE","oracleHome":"\u003cstring\u003e"}],"gridHomePath":"\u003cstring\u003e","licenseModel":"BRING_YOUR_OWN_LICENSE","rackSize":"QUARTER","storageGrid":{"displayName":"\u003cstring\u003e","entityType":"STORAGE_GRID_DISCOVER_SUMMARY","agentId":"\u003cstring\u003e","connectorId":"\u003cstring\u003e","discoverErrorCode":"\u003cstring\u003e","discoverErrorMsg":"\u003cstring\u003e","discoverStatus":"NEW_DISCOVERED","id":"\u003cstring\u003e","internalId":"\u003cstring\u003e","status":"\u003cstring\u003e","version":"\u003cstring\u003e","countOfStorageServersDiscovered":"\u003cinteger\u003e"},"storageServers":[{"displayName":"\u003cstring\u003e","entityType":"DATABASE_SYSTEM_DISCOVER_SUMMARY","agentId":"\u003cstring\u003e","connectorId":"\u003cstring\u003e","discoverErrorCode":"\u003cstring\u003e","discoverErrorMsg":"\u003cstring\u003e","discoverStatus":"NEW_DISCOVERED","id":"\u003cstring\u003e","internalId":"\u003cstring\u003e","status":"\u003cstring\u003e","version":"\u003cstring\u003e","connectorName":"\u003cstring\u003e","cpuCount":"\u003cinteger\u003e","ipAddress":"\u003cstring\u003e","makeModel":"\u003cstring\u003e","memoryGB":"\u003cdouble\u003e"},{"displayName":"\u003cstring\u003e","entityType":"DATABASE_SYSTEM_DISCOVER_SUMMARY","agentId":"\u003cstring\u003e","connectorId":"\u003cstring\u003e","discoverErrorCode":"\u003cstring\u003e","discoverErrorMsg":"\u003cstring\u003e","discoverStatus":"NEW_DISCOVERED","id":"\u003cstring\u003e","internalId":"\u003cstring\u003e","status":"\u003cstring\u003e","version":"\u003cstring\u003e","connectorName":"\u003cstring\u003e","cpuCount":"\u003cinteger\u003e","ipAddress":"\u003cstring\u003e","makeModel":"\u003cstring\u003e","memoryGB":"\u003cdouble\u003e"}]}