• To change the REST server listening IP or Port, under the “[SHMREST]” section of the conguration le, modify the IP value to
indicate which IP and port the REST server must bind to. By default, the REST server binds to 127.0.0.1:8012.
NOTE: Firewall services will most likely need to be modied in order to access the REST server from remote servers.
Accessing the REST service
The base URL for a REST request is in the following format:
http://<host>:<port>/api/<Program_Space>/<version>
Table 32. Accessing the REST service
Parameter Description
Host The address of the host running the REST server. This address can be the Fully Qualied Domain Name
(FQDN) of the host or an IP address.
Port The port number opened for REST trac. The default port is 8012.
Program_Space The application namespace: “SEM”.
Version The mainly supported version is 1.0 and later.
For example, the base URL http://127.0.0.1:8012/api/SEM/1.0/ is used to access the REST server locally.
NOTE
: For the remainder of this chapter, [base_url] is used in place of the base URL syntax.
To obtain information about dierent devices, you must use the following REST query:
[base_url]/<item_group>
To obtain information about a single device, you must use the following REST query:
[base_url]/<item_group>/<index | wwid>
The <item_group> variable represents the dierent types of devices contained within the storage enclosure. Following are the item_ group
values (device types):
• adapters
2
• currentsensors
• drawers
• drives
1, 2
• driveslots
• enclosures
2
• emms
1
• emmslots
• fans
• locks
• powersupplies
• voltagesensors
NOTE
:
1
EMM and drive item groups are queried at a higher level without having to reference an adapter or enclosure.
NOTE:
2
Adapters, enclosures, and drives are the only item groups that can provide more information about a single device in the
item group by specifying an index value or World Wide ID (WWID).
The Dell Storage enclosure REST API 47