org.ovirt.engine.sdk4.services

Interface EventsService.AddRequest

All Superinterfaces:

Request<EventsService.AddRequest,EventsService.AddResponse>

Enclosing interface:

EventsService

public static interface EventsService.AddRequest
extends Request<EventsService.AddRequest,EventsService.AddResponse>

Adds an external event to the internal audit log.

This is intended for integration with external systems that detect or produce events relevant for the administrator of the system. For example, an external monitoring tool may be able to detect that a file system is full inside the guest operating system of a virtual machine. This event can be added to the internal audit log sending a request like this:

POST /ovirt-engine/api/events
<event>
  <description>File system /home is full</description>
  <severity>alert</severity>
  <origin>mymonitor</origin>
  <custom_id>1467879754</custom_id>
</event>

Events can also be linked to specific objects. For example, the above event could be linked to the specific virtual machine where it happened, using the vm link:

POST /ovirt-engine/api/events
<event>
  <description>File system /home is full</description>
  <severity>alert</severity>
  <origin>mymonitor</origin>
  <custom_id>1467879754</custom_id>
  <vm id="aae98225-5b73-490d-a252-899209af17e9"/>
</event>

Note	When using links, like the vm in the previous example, only the id attribute is accepted. The name attribute, if provided, is simply ignored.

Method Summary

Modifier and Type	Method and Description
EventsService.AddRequest	event(Event event)
EventsService.AddRequest	event(EventBuilder event)

Methods inherited from interface org.ovirt.engine.sdk4.Request

send

Method Detail

event

EventsService.AddRequest event(Event event)

event

EventsService.AddRequest event(EventBuilder event)