SoftLayer_Network_Vlan


SoftLayer_Network_Vlan

Description

Virtual LANs are an integral part of SoftLayer' s public and private networks. A VLAN is a networking concept in which network interfaces on different routers, switches, and servers act as if they’re on the same local network broadcast domain. This kind of network segmentation helps keep SoftLayer customers' networks separate from each other and provides a convenient mechanism for routing new IP subnets to servers. They also enable easy IP address sharing and swapping between servers on the same VLAN. SoftLayer servers are provisioned on private VLANs per router on the public and private networks.

The SoftLayer_Network_Vlan service controls these VLANs and provides relationships between VLANs, subnets, IP addresses, and network components.

seeAlso

Methods

editObject

Edit a VLAN’s properties

getAccount

Retrieve the SoftLayer customer account associated with a VLAN.

getAdditionalPrimarySubnets

Retrieve a VLAN’s additional primary subnets. These are used to extend the number of servers attached to the VLAN by adding more ip addresses to the primary IP address pool.

getAttachedNetworkGateway

Retrieve the gateway this VLAN is inside of.

getAttachedNetworkGatewayFlag

Retrieve whether or not this VLAN is inside a gateway.

getAttachedNetworkGatewayVlan

Retrieve the inside VLAN record if this VLAN is inside a network gateway.

getBillingItem

Retrieve the billing item for a network vlan.

getCancelFailureReasons

Get a set of reasons why this VLAN may not be cancelled.

getDedicatedFirewallFlag

Retrieve a flag indicating that a network vlan is on a Hardware Firewall (Dedicated).

getExtensionRouter

Retrieve the extension router that a VLAN is associated with.

getFirewallGuestNetworkComponents

Retrieve a firewalled Vlan’s network components.

getFirewallInterfaces

Retrieve a firewalled vlan’s inbound/outbound interfaces.

getFirewallNetworkComponents

Retrieve a firewalled Vlan’s network components.

getFirewallProtectableIpAddresses

Get the IP addresses associated with this server that are protectable by a network component firewall.

getFirewallProtectableSubnets

Get the subnets associated with this server that are protectable by a network component firewall.

getFirewallRules

Retrieve the currently running rule set of a firewalled VLAN.

getGuestNetworkComponents

Retrieve the networking components that are connected to a VLAN.

getHardware

Retrieve all of the hardware that exists on a VLAN. Hardware is associated with a VLAN by its networking components.

getLocalDiskStorageCapabilityFlag

Retrieve a flag indicating that a vlan can be assigned to a host that has local disk functionality.

getNetwork

Retrieve the network in which this VLAN resides.

getNetworkComponentTrunks

Retrieve the network components that are connected to this VLAN through a trunk.

getNetworkComponents

Retrieve the networking components that are connected to a VLAN.

getNetworkComponentsTrunkable

Retrieve the viable trunking targets of this VLAN. Viable targets include accessible components of assigned hardware in the same pod and network as this VLAN, which are not already natively attached nor trunked.

getNetworkSpace

Retrieve identifier to denote whether a VLAN is used for public or private connectivity.

getNetworkVlanFirewall

Retrieve the Hardware Firewall (Dedicated) for a network vlan.

getObject

Retrieve a SoftLayer_Network_Vlan record.

getPrimaryRouter

Retrieve the primary router that a VLAN is associated with. Every SoftLayer VLAN is connected to more than one router for greater network redundancy.

getPrimarySubnet

Retrieve a VLAN’s primary subnet. Each VLAN has at least one subnet, usually the subnet that is assigned to a server or new IP address block when it’s purchased.

getPrimarySubnetVersion6

Retrieve a VLAN’s primary IPv6 subnet. Some VLAN’s may not have a primary IPv6 subnet.

getPrivateNetworkGateways

Retrieve the gateways this VLAN is the private VLAN of.

getPrivateVlan

Retrieve a VLAN’s associated private network VLAN.

getPrivateVlanByIpAddress

Retrieve the private network VLAN associated with an IP address.

getPublicNetworkGateways

Retrieve the gateways this VLAN is the public VLAN of.

getPublicVlanByFqdn

Retrieve a server’s public VLAN based on it’s fully-qualified domain name

getReverseDomainRecords

Retrieve all reverse DNS records associated with a VLAN.

getSanStorageCapabilityFlag

Retrieve a flag indicating that a vlan can be assigned to a host that has SAN disk functionality.

getScaleVlans

Retrieve collection of scale VLANs this VLAN applies to.

getSecondaryRouter

Retrieve the secondary router that a VLAN is associated with. Every SoftLayer VLAN is connected to more than one router for greater network redundancy.

getSecondarySubnets

Retrieve the subnets that exist as secondary interfaces on a VLAN

getSubnets

Retrieve all of the subnets that exist as VLAN interfaces.

getTagReferences

Retrieve references to all tags for this VLAN.

getTotalPrimaryIpAddressCount

Retrieve the number of primary IP addresses in a VLAN.

getType

Retrieve the type of this VLAN.

getVirtualGuests

Retrieve all of the Virtual Servers that are connected to a VLAN.

getVlanForIpAddress

Retrieve an IP addresses’s associated VLAN.

updateFirewallIntraVlanCommunication

Update a VLAN’s firewall to allow or disallow intra-VLAN communication.

upgrade

Convert the VLAN to a paid resource. That is, from an Automatic to a Premium VLAN.