getFrontendIncomingBandwidth

Classes SoftLayer_Hardware
Tags method sldn hardware

SoftLayer_Hardware::getFrontendIncomingBandwidth

Retrieve the amount of incoming public network bandwidth used by a server over a period of time.

Description

The ‘‘‘getFrontendIncomingBandwidth’’’ method retrieves the amount of incoming public network traffic used by a server between the given start and end date parameters. When entering the ‘‘dateTime’’ parameter, only the month, day and year of the start and end dates are required - the time (hour, minute and second) are set to midnight by default and cannot be changed. The amount of bandwidth retrieved is measured in gigabytes (GB).

Parameters

Name Type Description
startDate dateTime The start date for the range of bandwidth to retrieve.
endDate dateTime The end date for the range of bandwidth to retrieve.

Required Headers

Optional Headers

  • None

Return Values

  • float

Error Handling

  • Throw the exception “Please provide a start date.” if no starting date parameter is given.
  • Throw the exception “Please provide an end date.” if no ending date parameter is given. 
curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [dateTime, dateTime]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Hardware/{SoftLayer_HardwareID}/getFrontendIncomingBandwidth'