Set the speed and redundancy configuration of a server’s public network interface.
Set the public 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.
In order to provide a period of transition to the new API, some backwards compatible behaviors will be active during this period.
|newSpeed||integer||Desired speed or -1 for maximum available, 0 for disconnect|
|redundancy||string||The desired state of redundancy for the interface(s)|