API Guide

The iDRAC implementation of a Redsh service supports only HTTPS notications. In certain situations, iDRAC may not be able to verify
certicates sent by a peer. To handle such situations, iDRAC can be congured to skip certicate verication by using the attribute
iDRAC.RedfishEventing.IgnoreCertificateErrors. This attribute can be congured to True or False (Default) using
RACADM or the WS-MAN interface. Set this attribute to True if certicate validation is not required.
Redsh service provides Lifecycle and Alert events. Lifecycle events may occur when resources are created, modied, or destroyed. Alert
events occur when a resource needs to indicate a signicant event. Alert events may be either directly or indirectly pertaining to the
resource. Examples of these kinds of event are a chassis being opened, button being pressed, cable being unplugged, or threshold being
exceeded. iDRAC supports up to 20 event subscriptions.
NOTE: In this release, iDRAC supports only Alert event
notications.
If an event delivery fails, the event service of iDRAC retries delivering the failed event. The number of retries and delivery intervals can be
congured using the following attributes:
• iDRAC.RedfishEventing.DeliveryRetryAttempts
• iDRAC.RedfishEventing.DeliveryRetryIntervalInSeconds
Event delivery retry settings in RACADM
iDRAC.RedshEventing.DeliveryRetryAttempts (Read or Write)
Description Species the number of retry attempts made for Redsh event delivery
Legal values Value ranges from 0 to 5
Default value 3
Write privilege Congure iDRAC
iDRAC.RedshEventing.DeliveryRetryIntervalInSeconds (Read or Write)
Description
Species the intervals (in seconds) of retry attempts made for Redsh event delivery
Legal values Value ranges from 5 to 60
Default value 30
Write privilege Congure iDRAC
Eventing operations
The Redsh event service provides the following URIs:
Table 2. Eventing operations
HTTP method type Description URI Metadata reference
GET Get Event Service detailed
information
/redsh/v1/EventService EventService.xml
POST Register an event notication
receiver
/redsh/v1/EventService/
Subscriptions
EventDestination.xml
DELETE Remove a subscription /redsh/v1/EventService/
Subscriptions/<Subscription ID>
EventService.xml
PowerEdge FX2 and FX2s chassis management using
iDRAC Redsh
On a PowerEdge FX2/FX2s chassis, iDRAC can monitor and manage chassis components such as fans, power supplies, and so on. Redsh
service provides information about chassis components when Chassis Management and Monitoring is set to Enabled on iDRAC. This
12
Redsh-based systems management