Use a GET request to retrieve information about an Oracle ILOM resource.
Request Format
GET <Resource_Path> HTTP/1.1 <Header Name> : <Header Value>
Request Header Fields Required
The required request header fields are as follows: Authorization, Accept, and Host.
For a description of these required header fields, see Common Request Header Fields.
Response Status Codes
Success: HTTP Status = 200 OK
Failure: HTTP Status = 4xx, 5xx
Response Body (Success Status)
When an entity corresponding to the requested resource is found, Oracle ILOM returns the details associated with the requested resource in the response body. In which case, the details in the response body can include: name|value pair properties, a collection of target resources, and a collection of non-CRUD actions supported for the target resource.
{ "Target": "<target URI path>", "property1 name": "property1 value", ... "propertyn name": "propertyn value", "Targets": [ { "name": "<name of target1>", "uri": "<URI path of target1>" }, ... { "name": "<name of targetx>", "uri": "<URI path of targetx>" } ], "Actions": [ { "name": "action1" }, ... { "name": "actionx" } ] }
Where:
The "Target" property would define the resource path.
The "Property name:value" pairs would define the property name and value.
The "Targets", if any, would define a collection of other accessible resources.
The "Actions", if any, would define non-CRUD actions that are applicable to the resource.
Response Body (Failed Status)
When an entity corresponding to the requested resource is not found, the response body returned includes an HTTP failure status code, as well as details describing the failure. For more details, see REST API Error Response.
Example: HTTP Request
In the following HTTP example, a request is sent to the server SP to retrieve information about the /System resource.
GET /rest/v1/System HTTP/1.1 Accept: application/json
Upon successfully locating the /System resource, the Oracle ILOM REST API returns the /System resource details in a JSON response body format, for example:
{ "Actions": [ { "name": "power-on" }, { "name": "power-off" }, { "name": "soft-power-off" }, { "name": "reset" } ], "Target": "/rest/v1/System", "Targets": [ { "name": "Open_Problems", "uri": "/rest/v1/System/Open_Problems" }, { "name": "Processors", "uri": "/rest/v1/System/Processors" }, { "name": "Memory", "uri": "/rest/v1/System/Memory" }, { "name": "Power", "uri": "/rest/v1/System/Power" }, { "name": "Cooling", "uri": "/rest/v1/System/Cooling" }, { "name": "Storage", "uri": "/rest/v1/System/Storage" }, { "name": "Networking", "uri": "/rest/v1/System/Networking" }, { "name": "PCI_Devices", "uri": "/rest/v1/System/PCI_Devices" }, { "name": "Firmware", "uri": "/rest/v1/System/Firmware" }, { "name": "BIOS", "uri": "/rest/v1/System/BIOS" }, { "name": "Log", "uri": "/rest/v1/System/Log" } ], "actual_power_consumption": 20, "health": "Service Required", "health_details": "PS1 (Power Supply 1) is faulty.", "host_primary_mac_address": "<MAC address>", "ilom_address": "<IP address>", "ilom_mac_address": "<MAC address>", "locator_indicator": false, "model": "ORACLE SERVER X5-2L", "open_problems_count": 1, "part_number": "X5-2L-P1.LAST-20", "power_state": "Off", "primary_operating_system": "Not Available", "primary_operating_system_detail": "<details>", "qpart_id": "<QPART id>", "serial_number": "<serial number>", "system_fw_version": "<ILOM fw version>", "system_identifier": "", "type": "Rack Mount" }