Documentation forIP Address Manager
Managing IP addresses is a key capability of SolarWinds Observability Self-Hosted (formerly Hybrid Cloud Observability) and is available in the Essentials edition. IP Address Manager (IPAM) is also available in a standalone module.

Use the SWIS API to perform IPAM operations

You can use Windows PowerShell and the SolarWinds SDK to manage IP addresses in IPAM. The IPAM-specific API fields are documented on the IPAM API wiki page in the SolarWinds SDK.

Currently IPAM API does not support parallel execution of tasks.

Supported operations:

  • Get the first available IP address for a specified subnet
  • Change IP node status
  • Start, finish, and cancel an IP address reservation
  • Create a new subnet
  • Add a DNS 'A' record for an IP address
  • Change a DNS 'A' record for an IP address
  • Remove a DNS 'A' record for an IP address
  • Add an 'A' record with an associated PTR for a zone
  • Add PTR to a DNS 'A' record
  • Create an IP address reservation on a DHCP server
  • Remove an IP address reservation from a DHCP server
  • Get an 'A' recorde and PTR records for a DNS zone
  • Create a custom property
  • Update a custom property
  • Reorder a custom property
  • Delete a custom property
  • CRUD operations for subnets
  • CRUD operations for IP addresses

Pre-requisites

  • Verify that at least PowerShell 4.0 is installed:
    • Open PowerShell and enter $PSVersionTable.PSVersion to determine the PowerShell engine version.
    • The major version should be 4 or higher.
  • Install the SolarWinds SDK if you have not yet installed it:
  • Learn the basics of using the SolarWinds SDK in PowerShell.
  • In PowerShell, add the SwisSnapin if you have not yet added it:
    • Add the SwisSnapin by running the Add-PSSnapin cmdlet: Add-PSSnapin -Name SwisSnapin

    For more information, open the SolarWinds SDK PowerShell page and follow the steps in the "Using SwisSnapin" section.

Get started with the API

This section provides instructions on how to use Windows PowerShell, although you can also use Python OrionSDK to call to the API.

  1. Open Windows PowerShell ISE to test the example(s).

    Enter Windows-key+R to open the Run dialog.

    Type powershell ise and press OK.

  2. In PowerShell ISE, create a SWIS connection object using the Connect-Swis cmdlet.

    For details, open the SolarWinds SDK PowerShell page on GitHub and follow the steps in the "Cmdlets Provided by SwisSnapin" section.

  3. In PowerShell ISE, enter the IPAM API cmdlets and run them. See the IPAM API reference for documentation.