getHourlyBandwidth


SoftLayer_Hardware::getHourlyBandwidth

Retrieves bandwidth hourly over a 24-hour period for the specified hardware.

Description

The ‘‘‘getHourlyBandwidth’’’ method retrieves all bandwidth updates hourly for the specified hardware. Because the potential number of data points can become excessive, the method limits the user to obtain data in 24-hour intervals. The required ‘‘dateTime’’ parameter is used as the starting point for the query and will be calculated for the 24-hour period starting with the specified date and time. For example, entering a parameter of

‘02/01/2008 0:00’

results in a return of all bandwidth data for the entire day of February 1, 2008, as 0:00 specifies a midnight start date. Please note that the time entered should be completed using a 24-hour clock (military time, astronomical time).

For data spanning more than a single 24-hour period, refer to the getBandwidthData function on the metricTrackingObject for the piece of hardware.


Parameters

Name Type Description
mode string Specifies the ‘public’ or ‘private’ port for this server.
day dateTime A date and time formatted as ‘MM/DD/YYYY HH:00’

Required Headers

Optional Headers

  • None

Return Values

curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [string, dateTime]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Hardware/{SoftLayer_HardwareID}/getHourlyBandwidth'