1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
.. image:: /images/hpe_logo2.png
:width: 150pt
|
.. toctree::
:maxdepth: 1
===========
Quick Start
===========
This is a basic detailed breakdown of `quickstart.py
<https://github.com/HewlettPackard/python-ilorest-library/tree/master/examples/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
<https://github.com/HewlettPackard/python-ilorest-library/tree/master/examples/RestfulApiExamples.py>`_
and `RedfishApiExamples.py
<https://github.com/HewlettPackard/python-ilorest-library/tree/master/examples/RedfishApiExamples.py>`_.
Make sure that redfish library is imported.
.. code-block:: python
import redfish
The very first thing that needs to be done for a restful request is to create a
rest object.
Create a Redfish 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.
.. code-block:: python
REST_OBJ = redfish.redfish_client(base_url=host,username=login_account,
password=login_password, default_prefix='/redfish/v1')
Create a Rest Object
====================
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.
.. code-block:: python
REST_OBJ = redfish.rest_client(base_url=host,username=login_account,
password=login_password, default_prefix='/rest/v1')
Create a login session
======================
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.
.. code-block:: python
REST_OBJ.login(auth="session")
Please remember to call **logout** method once the session is completed.
Perform first Restful API operation
===================================
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 HP 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.
.. code-block:: python
response = REST_OBJ.get('/rest/v1/systems/1')
Print the HTTP GET response, the response includes response status, response
header and response body.
.. code-block:: python
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):
.. image:: /images/iLO_sys1.jpg
:height: 200
Close the login session
-----------------------
Logout of the current session.
.. code-block:: python
REST_OBJ.logout()
Additional Examples
===================
Please look into the `examples <Examples.html>`_ section for more details on
how to perform certain iLO tasks through RESTful requests using scripts.
|
