HP OneView REST API Reference

enclosures
enclosures.html[10/17/2013 10:35:21 AM]
Get a single sign-on URL for the active Onboard
Administrator of the enclosure.
GET https://{appl}/rest/enclosures/{id}/activeOaSsoUrl
URI: /rest/enclosures/{id}/utilization
Method API
GET Retrieves historical utilization data for the specified enclosure, metrics, and time span.
Parameter Attributes Description
refresh Optional Specifies that if necessary an additional request will be queued to obtain the most
recent utilization data from the enclosure. The response will not include any
refreshed data. To track the availability of the newly collected data, monitor the
TaskResource identified by the refreshTaskUri property in the response. If null,
no refresh was queued.
view Optional Specifies the resolution interval length of the samples to be retrieved. This is
reflected in the resolution in the returned response. Utilization data is
automatically purged to stay within storage space constraints. Supported views are
listed below.
native
Resolution of the samples returned will be one sample for each 5-minute
time period. This is the default view and matches the resolution of the data
returned by the enclosure. Samples at this resolution are retained up to
one year.
hour
Resolution of the samples returned will be one sample for each 60-minute
time period. Samples are calculated by averaging the available 5-minute
data samples that occurred within the hour, except for PeakPower which is
calculated by reporting the peak observed 5-minute sample value data
during the hour. Samples at this resolution are retained up to three years.
day
Resolution of the samples returned will be one sample for each 24-hour
time period. One day is a 24-hour period that starts at midnight GMT
regardless of the time zone in which the appliance or client is located.
Samples are calculated by averaging the available 5-minute data samples
that occurred during the day, except for PeakPower which is calculated by
reporting the peak observed 5-minute sample value data during the day.
Samples at this resolution are retained up to three years.
fields Optional Name of the metric(s) to be retrieved in the format METRIC[,METRIC]... Enclosures
support the following utilization metrics:
AmbientTemperature
Inlet air temperature in degrees Celsius during this sample interval.
AveragePower
Average power consumption in Watts during this sample interval.
PeakPower
Peak power consumption in Watts during this sample interval.
PowerCap
Dynamic power cap setting on the server hardware in Watts during this
sample interval.
DeratedCapacity
Enclosure dynamic power cap derated capacity setting in Watts during this
sample interval.