whois

Classes SoftLayer_Utility_Network
Tags method sldn utility

SoftLayer_Utility_Network::whois

Perform a WHOIS lookup on a given address.

Description

Perform a WHOIS lookup from SoftLayer’s application servers on the given IP address or hostname and return the raw results of that command. The returned result is similar to the result received from running the command whois from a UNIX command shell. A WHOIS lookup queries a host’s registrar to retrieve domain registrant information including registration date, expiry date, and the administrative, technical, billing, and abuse contacts responsible for a domain. WHOIS lookups are useful for determining a physical contact responsible for a particular domain. WHOIS lookups are also useful for determining domain availability. Running a WHOIS lookup on an IP address queries ARIN for that IP block’s ownership, and is helpful for determining a physical entity responsible for a certain IP address.

Parameters

Name Type Description
address string An IP address or hostname to whois.

Required Headers

Optional Headers

  • None

Return Values

  • string

Error Handling

  • Throw the exception “Please provide an address to whois.” if the address parameter is empty.
  • Throw the exception “Please provide a valid IP address or hostname.” if the address parameter is not a valid IP address or hostname.

Associated Methods

curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [string]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Utility_Network/whois'