• You must be running on a server with iLO and the latest iLO drivers from the SPP.
• You will need the download the iLOrest Chif DLL/SO for your corresponding operating system: https://github.com/HewlettPackard/python-ilorest-library#inband-communication

Instead of HTTPS, CHIF is used for the transportation. The HPE python iLO Restful library provides support for both remote (HTTPS) and in-band (CHIF).

Make sure that ilorest library is imported.

import redfish

:

Creation of local rest/redfish objects are same as remote rest/redfish object creation with the exception of the local hostname being 'blobstore://.'. Once the object is created with proper hostname, the iLO Restful API provides the built-in support of performing RESTful requests on local machine iLO.

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('blobstore://.'), 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('blobstore://.'), 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 a GET request on the iLO and returns a HTTP style response.

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)

:

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.