Find hardware by its primary public or private IP (ipv4) address.


The ‘‘‘findByIpAddress’’’ method finds hardware using its primary public or private IP address. IP addresses that have a secondary subnet tied to the hardware will not return the hardware. If no hardware is found, no errors are generated and no data is returned.


Name Type Description
ipAddress string An IP (ipv4) address by which to search for hardware

Required Headers

  • authenticate

Optional Headers

  • SoftLayer_Hardware_ServerObjectMask
  • SoftLayer_ObjectMask

Return Values

Error Handling

  • SoftLayer_Exception

“Invalid IP address of [ip address] defined.”