API Guide
replaced using the iDRAC interfaces such as web interface, RACADM, or WS-MAN. For more information on managing SSL
certificates of iDRAC, see the latest iDRAC User’s Guide available at dell.com/idracmanuals.
Eventing
The Redfish service generates asynchronous notifications (events) that are defined by Redfish subscription for the eventing
service. These events are sent to an event destination by using HTTP POST method. Events are generated when some significant
change or error condition typically of time critical nature occurs. When an event occurs on the service, it notifies the clients. Redfish
service must be enabled and iDRAC must be configured to create event subscriptions and to gain read-only privilege for viewing
event subscriptions.
The iDRAC implementation of a Redfish service supports only HTTPS notifications. In certain situations, iDRAC may not be able to
verify certificates sent by a peer. To handle such situations, iDRAC can be configured to skip certificate verification by using the
attribute iDRAC.RedfishEventing.IgnoreCertificateErrors. This attribute can be configured to True or False
(Default) using RACADM or the WS-MAN interface. Set this attribute to True if certificate validation is not required.
NOTE: In this release, this attribute is read-only and is set to True.
Redfish service provides Lifecycle and Alert events. Lifecycle events may occur when resources are created, modified, or destroyed.
Alert events occur when a resource needs to indicate a significant event. This may be either directly or indirectly pertaining to the
resource. Examples of this kind of event are when a chassis is opened, button is pressed, cable is unplugged, or threshold is
exceeded. iDRAC supports up to 20 event subscriptions.
NOTE: In this release, iDRAC supports only Alert event notifications.
In case an event delivery fails, the event service of iDRAC retries delivering the failed event. The number of retries and delivery
intervals can be configured using the following attributes:
• iDRAC.RedfishEventing.DeliveryRetryAttempts
• iDRAC.RedfishEventing.DeliveryRetryIntervalInSeconds
Event Delivery Retry Settings in RACADM
Table 1. iDRAC.Redfisheventing.DeliveryRetryAttempts (Read or Write)
Description
Specifies the number of retry attempts made for Redfish event
delivery
Legal Values Value ranges from 0 to 5
Default Value 3
Write Privilege Configure iDRAC
Table 2. iDRAC.Redfisheventing.DeliveryRetryIntervalInSeconds (Read or Write)
Description
Specifies the intervals (in seconds) of retry attempts made for
Redfish event delivery
Legal Values Value ranges from 5 to 60
Default Value 30
Write Privilege Configure iDRAC
Eventing Operations
The Redfish event service provides the following URIs:
11