SoftLayer Hardware Server::getPublicNetworkComponent

From SoftLayer Development Network Wiki

getPublicNetworkComponent is a member of the SoftLayer_Hardware_Server service.

Contents 1 Overview 2 User Access 3 Return Type 4 Headers 4.1 Required Headers 4.2 Optional Headers 5 Error Handling

Overview

Retrieve a SoftLayer server's public network component. Some servers are only connected to the private network and may not have a public network component. In that case getPublicNetworkCompnent returns a null object.

User Access

Users wishing to execute getPublicNetworkComponent must have the following permissions assigned to their account:

• View Hardware Details

Return Type

getPublicNetworkComponent returns the SoftLayer_Network_Component data type.

Headers

Required Headers

getPublicNetworkComponent requires the following headers set:

• authenticate
• SoftLayer_Hardware_ServerInitParameter

Optional Headers

getPublicNetworkComponent takes the following optional headers:

• SoftLayer_Hardware_ServerObjectMask

Error Handling

getPublicNetworkComponent throws the following exceptions:

• SoftLayer_Exception

Throw the exception "Unable to locate this server's public networking component." if the API is unable to locate a management componenet for this server.