SoftLayer Utility Network::whois

From SoftLayer Development Network Wiki

Jump to: navigation, search

whois is a member of the SoftLayer_Utility_Network service.

Contents

Overview

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.

Return Type

whois returns the string data type.

Headers

Required Headers

whois requires the following headers:

Parameters

whois takes the following parameters:

address

An IP address or hostname to whois.

  • Type: string

Error Handling

whois throws the following exceptions:

  • SoftLayer_Exception_Public
Throw the exception "Please provide an address to whois." if the address parameter is empty.
  • SoftLayer_Exception_Public
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

External Links

Personal tools