This is a basic detailed breakdown of quickstart.py examples. This will cover object creation and a simple call to the API. For more elaborate example that use the API and Python library look at the examples in RestfulApiExamples.py and RedfishApiExamples.py.

Make sure that ilorest library is imported.

import redfish

The very first thing that needs to be done for a restful request is to create a rest object.

A Redfish Rest object instance is created by calling the redfish_client method of the imported redfish library. The redfish_client method returns an instance of the Redfish RESTful client and takes as parameters iLO hostname/ ip address, user name, password, default rest prefix ('/redfish/v1') and other optional arguments.

REST_OBJ = redfish.redfish_client(base_url=host,username=login_account, 
                                password=login_password, default_prefix='/redfish/v1')

:

A Rest object instance is created by calling the rest_client method of the imported redfish library. The rest_client method returns an instance of the RESTful client and takes as parameters iLO hostname/ ip address, user name, password, default rest prefix ('/rest/v1') and other optional arguments.

REST_OBJ = redfish.rest_client(base_url=host,username=login_account,
                             password=login_password, default_prefix='/rest/v1')

:

Next the rest object's login method is called to initiate a rest session. The parameters for the login method are iLO user name, password and login type (default is Basic authentication). For "session" login, a session key is generated through a rest request.

REST_OBJ.login(auth="session")

:

Please remember to call logout method once the session is completed.

This is a very simple request example that shows the basic libraries involved and how to properly form the request. The following example performs a GET operation on the systems resource (/rest/v1/systems/1) using the HPE Restful API for iLO. It does an HTTP GET request on the iLO SSL(HTTPS) port (typically 443 but the iLO can be configured to use another port as well). The interface is not available over open HTTP (port 80), so SSL handshake must be used.

After creating a Redfish/Rest object as mentioned above in Create a Rest Object section followed by a login session.

Next the Rest object's get method is called with the system uri (/rest/v1/systems/1) as the parameter. For this simple GET example no additional parameter is required but the Rest object's put and post method may take request header and body as parameters while patch method can take request body as parameter.

response = REST_OBJ.get('/rest/v1/systems/1')

:

Print the HTTP GET response, the response includes response status, response header and response body.

sys.stdout.write("%s\n" % response)

:

Response status:

200

Response header:

content-length 4135
server HPE-iLO-Server/1.30
connection keep-alive
etag W/"F7BDA039"
link </rest/v1/SchemaStore/en/ComputerSystem.json>; rel=describedby
allow GET, HEAD, POST, PATCH
cache-control no-cache
date Mon, 14 Mar 2016 10:05:32 GMT
x-frame-options sameorigin
x_hp-chrp-service-version 1.0.3
content-type application/json; charset=utf-8

Response body (formatted using Postman):

Logout of the current session.

REST_OBJ.logout()

:

Please look into the examples section for more details on how to perform certain iLO tasks through RESTful requests using scripts.