SoftLayer Hardware Server::getPrivateBandwidthGraphImage

From SoftLayer Development Network Wiki

Jump to: navigation, search

getPrivateBandwidthGraphImage is a member of the SoftLayer_Hardware_Server service.

Contents

Overview

Retrieve a graph of a server's private network bandwidth usage over the specified timeframe. If no timeframe is specified then getPrivateBandwidthGraphImage retrieves the last 24 hours of private bandwidth usage. getPrivateBandwidthGraphImage returns a PNG image measuring 827 pixels by 293 pixels.

User Access

Users wishing to execute getPrivateBandwidthGraphImage must have the following permissions assigned to their account:

  • View Hardware Details

Return Type

getPrivateBandwidthGraphImage returns the base64Binary data type.

Headers

Required Headers

getPrivateBandwidthGraphImage requires the following headers set:

Parameters

getPrivateBandwidthGraphImage takes the following parameters:

startTimee

The starting point to retrieve bandwidth data from, specified as a date.

  • type: string



endTime

The ending point to retrieve bandwidth data from, specified as a date.

  • type: string

Error Handling

getPrivateBandwidthGraphImage throws the following exceptions:

  • SoftLayer_Exception
Throw the exception "Unable to retrieve the private bandwidth graph for server {id}." if the API is unable to retrieve a valid PNG bandwidth graph image.
  • SoftLayer_Exception
Throw the exception "The start time {startTime} is not a readable date format." if an invalid start time is passed to getPrivateBandwidthGraphImage.
  • SoftLayer_Exception
Throw the exception "The end time {endTime} is not a readable date format." if an invalid end time is passed to getPrivateBandwidthGraphImage.

External Links

Personal tools