shutdownPrivatePort


SoftLayer_Hardware_SecurityModule750::shutdownPrivatePort

Disconnect a server’s private network interface.

Overview

Disconnect a server’s private network interface. This operation is an alias for calling [[SoftLayer_Hardware_Server/setPrivateNetworkInterfaceSpeed]] with a $newSpeed of 0 and unspecified $redundancy.

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 disconnect the interface; thus changes are pending. A response of false indicates the interface was already disconnected, and thus no changes are pending.


Parameters

Name Type Description

Required Headers

  • authenticate
  • SoftLayer_Hardware_SecurityModule750InitParameters

Return Values

  • boolean

Associated Methods

Error Handling

  • SoftLayer_Exception_Unavailable

Throws If the requested network is not available to the server

  • SoftLayer_Exception_NotReady

Throws If a change, not necessarily a speed change, is pending against the server

  • SoftLayer_Exception_NotReady

Throws If the server is not yet available for interface speed changes

  • SoftLayer_Exception_AccessDenied

Throws If the user requesting the change lacks the Port Control permission