Administrator Guide

Table 31. Accessing the ReST service

Parameter Description

Host The address of the host running the ReST server. This address can be the Fully

Qualified Domain Name (FQDN) of the host or an IP address.

Port The port number opened for ReST traffic. The default port is 8012.

Program_Space The application namespace: “SEM”.

Version The major working version number. Currently “1.0”.

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 different 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 different types of devices contained within the storage

enclosure. Following are the item_group values (device types):

• adapters

• currentsensors

• drawers

• drives

1, 2

• driveslots

• enclosures

• emms

• emmslots

• fans

• locks

• powersupplies

• voltagesensors

NOTE:

EMM and drive item groups are queried at a higher level without having to reference an

adapter or enclosure.

NOTE:

Adapters, enclosures, and drives are the only item groups that can provide more detail on a

single device in the item group by specifying an index value or World Wide ID (WWID).

Device inventory

All GET commands available in the SHMCLI are implemented in the ReST API. The information returned

from a ReST query is different from the output of a SHMCLI command. ReST API calls return output

equivalent to the output of shmcli information commands.

The URL syntax for device queries is described here: