DRO events APIs

Edit online

Use the REST API to retrieve Dynamic Resource Optimizer (DRO) events from the IBM® Power® Virtualization Center database.

Retrieving Dynamic Resource Optimizer (DRO) events

Use this REST API to retrieve DRO stored events in the IBM Power Virtualization Center database.
Table 1. Rest API to retrieve all DRO events
Method URI Description

GET

/v2.1/{tenant_id}/dro-events

Retrieves all DRO events.

Request Parameters

Table 2. Parameters in the request field for stored DRO events
Name In Type Description

aggregate_id

body

integer

Specifies the ID of the host group for which DRO events should be retrieved.

id

body

integer

Specifies the ID of the DRO event.

event_start_tstamp

body

string

Specifies the start of DRO events to retrieve in terms of the time-stamp.

event_end_tstamp

body

string

Specifies the end of DRO events to retrieve in terms of the time-stamp.

exclude_event_type

body

string

Specifies an event type to exclude from the response.

hypervisor_hostname

body

string

Specifies the host for which DRO events should be retrieved.

Example:

GET events for the host named "host_1":
/v2/{tenant_id}/dro-events?hypervisor_hostname=host_1
GET up to 10 events for a specific host between specified times:
/v2/{tenant_id}/dro-events?max_events=10&hypervisor_hostname=host_a&event_start_tstamp=2015-07-13T04:40:00Z&event_end_tstamp=2015-07-13T04:57:00Z

Response

Response code:
Normal response code: OK (200)
Table 3. Responses from the initial query
Name In Type Description

aggregate_id

body

integer

The ID of the host group DRO event.

id

body

integer

The ID of the DRO event.

event_time

body

timestamp

The time-stamp of the event.

event_type

body

string

The type of event.

hypervisor_hostname

body

string

The host to which the event applies.

payload

body

string

The metadata of the event, which is a JSON-encoded string.
Example of Dynamic Resource Optimizer (DRO) event Responses
{   
"event_time": "2015-08-08T12:08:06.970307",    
"event_type": "prs.rtpolicy.hypervisor.alert",    
"hypervisor_hostname": "8246L2C_10024BA",    
"aggregate_id",
"id": 1, 
"payload": {                                                                                   
  "aggregate_id": 1,        
  "alert_times": 1,        
  "hypervisor_hostname": "8246L2C_10024BA",       
  "hypervisor_id": 1,       
  "is_violated": "No",       
  "policy_type": "rtpolicy",       
  "rtpolicy_id": 5,       
  "rtpolicy_name": "CPU Utilization Balance",       
  "stabilization": 2,       
  "threshold": 20    
 }
}