Hardware
SoftLayer_Hardware_Server::setPublicNetworkInterfaceSpeed

Overview

Sets the public network interface speed to the new speed. Speed values can only be 0 (Disconnect), 10, 100, 1000, and 10000. The new speed must be equal to or less than the max speed of the interface.

It will take less than a minute to update the switch port speed. The server uplink will not be operational again until the server interface speed is updated.

Parameters

newSpeed

integer

New speed for public network component

Headers

n/a
authenticate, SoftLayer_Hardware_ServerInitParameters

Return Values

boolean

Error Handling

  • SoftLayer_Exception_Public: Throws the exception 'Speed cannot be null and must be 0 (Disconnect), 10, 100, 1000 or 10000.' when the parameter being passed in is null.
  • SoftLayer_Exception_Public: Throws the exception 'You do not have permission to this service.' when a user does not have permission to Manage Port Control.
  • SoftLayer_Exception_Public: Throws the exception 'There is currently an outstanding transaction for this server.' when there is a current hardware update.
  • SoftLayer_Exception_Public: Throws the exception 'Speed must be 0 (Disconnect), 10, 100, 1000, or 10000.' when the speed being passed in is not in the list of accepted speeds.
  • SoftLayer_Exception_Public: Throws the exception 'You cannot set interface speed greater than max speed.' when the new speed is greater than the current max speed of the public interface.