setPrivateNetworkInterfaceSpeed


SoftLayer_Hardware_Server::setPrivateNetworkInterfaceSpeed

Set the speed and redundancy configuration of a server’s private network interface.

Overview

Note: All error handling and parameter documentation is referencing behavior available on January 4th, 2019.

Behavior deprecated on January 4th, 2019

Sets the private 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.

NEW! Behavior on January 4th, 2019

Set the private network interface speed and redundancy configuration.

Possible $newSpeed values are -1 (maximum available), 0 (disconnect), 10, 100, 1000, and 10000; not all values are available to every server. The maximum speed is limited by the speed requested during provisioning. All intermediate speeds are limited by the capability of the pod the server is deployed in. No guarantee is made that a speed other than what was requested during provisioning will be available.

If specified, possible $redundancy values are either “redundant” or “degraded”. Not specifying a redundancy mode will use the best possible redundancy available to the server. However, specifying a redundacy mode that is not available to the server will result in an error. “redundant” indicates all available interfaces should be active. “degraded” indicates only the primary interface should be active. Irrespective of the number of interfaces available to a server, it is only possible to have either a single interface or all interfaces active.

Receipt of a response does not indicate completion of the configuration change. Any subsequent attempts to request the interface change speed or state, while changes are pending, will result in a busy error.

A response of true indicates a change was required to achieve the desired interface configuration; thus changes are pending. A response of false indicates the current interface configuration matches the desired configuration, and thus no changes are pending.

Backwards Compatibility Until February 27th, 2019

In order to provide a period of transition to the new API, some backwards compatible behaviors will be active during this period.

  • A “doubled” (eg. 200) speed value will be translated to a redundancy value of “redundant”. If a redundancy value is specified, it is assumed no translation is needed and will result in an error due to doubled speeds no longer being valid.
  • A non-doubled (eg. 100) speed value without a redundancy value will be translated to a redundancy value of “degraded”.
After the compatibility period, a doubled speed value will result in an error, and a non-doubled speed value without a redundancy value specified will result in the best available redundancy state. An exception is made for the new relative speed value -1. When using -1 without a redundancy value, the best possible redundancy will be used. Please transition away from using doubled speed values in favor of specifying redundancy (when applicable) or using relative speed values 0 and -1.

Parameters

Name Type Description
newSpeed integer Desired speed or -1 for maximum available, 0 for disconnect

Required Headers

  • authenticate
  • SoftLayer_Hardware_ServerInitParameters

Optional Headers

Return Values

boolean

associatedMethods