HP OneView REST API Reference

power-devices
power-devices.html[10/17/2013 10:35:43 AM]
endDate minus 24 hours.
endDate
End date of requested starting time range in ISO 8601
format. When omitted the endDate includes the latest data
sample available.
If an excessive number of samples would otherwise be returned, the
results will be segmented. The caller is responsible for comparing the
returned sliceStartTime with the requested startTime in the
response. If the sliceStartTime is greater than the
oldestSampleTime and the requested start time, the caller is
responsible for repeating the request with endTime set to
sliceStartTime to obtain the next segment. This process is
repeated until the full data set is retrieved.
If the resource has no data, the UtilizationData is still returned, but
will contain no samples and sliceStartTime/sliceEndTime will
be equal. oldestSampleTime/newestSampleTime will still be set
appropriately (null if no data is available). If the filter just does not
happen to overlap the data that a resource does have, then the
metric history service will return null sample values for any missing
samples.
Request
Header
Attributes Description
REST API Request Headers NOTE: The X-API-Version header is required for all APIs. For the
current release, this must be set to "X-API-Version:3"
Response Description
UtilizationData UtilizationData for the specified resource.
Response Codes
REST API Response Codes
Examples
Get most recent 24-hour AveragePower & PeakPower data for power-device
36333636-3839-3032-3131-343430303130 (endDate should be present time):
https://{appl}/rest/power-devices/36333636-3839-3032-3131-
343430303130
/utilization?fields=AveragePower,PeakPower&filter=endDate=
20120403T113000.000Z
Get 24-hour data for power device between two specified dates at one
sample per hour resolution:
https://{appl}/rest/power-devices/36333636-3839-3032-3131-
343430303130
/utilization?fields=AveragePower&view=hour&
filter=startDate=20120401T202800.000Z&filter=
endDate=20120402T202800.000Z
Get all PeakPower data at one sample per day resolution for power
device 36333636-3839-3032-3131-343430303130:
https://{appl}/rest/power-devices/36333636-3839-3032-3131-
343430303130