Language: English

Network
SoftLayer_Network_Bandwidth_Version1_Allotment

Overview

Every SoftLayer Bandwidth Pooling, Virtual Datacenter, Virtual Private Rack(VPR) is defined in the SoftLayer_Network_Bandwidth_Version1_Allotment service as an allotment. SoftLayer allotments are a collection of servers that share all of the servers allocated bandwidth together.

Virtual Private Rack Each server is by default a part of your Virtual Private Rack. Bandwidth overages are billed individually per server for all hardware in your Virtual Private Rack. If any one server uses more bandwidth than it is allocated, an overage charge will result.

Bandwidth Pooling Bandwidth Pooling allow you to optimize your bandwidth usage by "pooling" all of the bandwidth together for servers in a Bandwidth Pooling. Bandwidth overages for servers in a Bandwidth Pooling are summed up as a whole and overages are calculated only if the total bandwidth of all servers exceeds the total allocated bandwidth for all servers.

For example, if you had 5 servers, each with 2000 GB of bandwidth, and one server used 3000 GB of bandwidth while the other used only 1500 GB of bandwidth, you would not be billed for an overage because your total usage would be 9000 GB and your total allocated would be 10000 GB.

Methods

create a new allotment by passing in a allotment object.
Edit a bandwidth allotment
Retrieve the account associated with this virtual rack.
Retrieve the average daily public bandwidth usage for the current billing cycle.
Retrieve the bandwidth allotment type of this virtual rack.
Retrieve bandwidth data from a tracking object.
generate a graph image of all the bandwidth usage for an entire allotment of servers.
Retrieve the bare metal server instances contained within a virtual rack.
Retrieve a virtual rack's raw bandwidth usage data for an account's current billing cycle. One object is returned for each network this server is attached to.
Retrieve a virtual rack's raw private network bandwidth usage data for an account's current billing cycle.
Retrieve a virtual rack's raw public network bandwidth usage data for an account's current billing cycle.
Retrieve the total public bandwidth used in this virtual rack for an account's current billing cycle.
Retrieve a virtual rack's billing item.
Retrieve an object that provides commonly used bandwidth summary components for the current billing cycle.
Retrieve bandwidth graph by date.
Retrieve the hardware contained within a virtual rack.
Retrieve the total public inbound bandwidth used in this virtual rack for an account's current billing cycle.
Retrieve the location group associated with this virtual rack.
Retrieve the managed bare metal server instances contained within a virtual rack.
Retrieve the managed hardware contained within a virtual rack.
Retrieve the managed Virtual Server contained within a virtual rack.
Retrieve a virtual rack's metric tracking object. This object records all periodic polled data available to this rack.
Retrieve the metric tracking object id for this allotment.
Retrieve a SoftLayer_Network_Bandwidth_Version1_Allotment record.
Retrieve the total public outbound bandwidth used in this virtual rack for an account's current billing cycle.
Retrieve whether the bandwidth usage for this bandwidth pool for the current billing cycle exceeds the allocation.
Retrieve the private network only hardware contained within a virtual rack.
Retrieve whether the bandwidth usage for this bandwidth pool for the current billing cycle is projected to exceed the allocation.
Retrieve the projected public outbound bandwidth for this virtual server for the current billing cycle.
Retrieve the combined allocated bandwidth for all servers in a virtual rack.
Gets the monthly recurring fee of a pooled server.
Retrieve the Virtual Server contained within a virtual rack.
reassign a collection of servers to a different allotment.
cancel a bandwidth pooling and assign contents, if any, to bandwidth pool.
Move servers into our out of a bandwidth pool.
Update bandwidth pool.
unassign a collection of servers from an allotment and insert them into the accounts VPR.