SOLARWINDS API CODE
SOLARWINDS API PASSWORD
SOLARWINDS API SERIES
SOLARWINDS API DOWNLOAD

Postman makes this simple with its pre-request scripts. To get started, scroll up from the response we just saw and 1) click the вЂBodyвЂ™ link, 2) change the radio button to вЂRawвЂ™, and 3) change the format to JSON (application/json).ДЇor the request weвЂ™re going to need the current UTC datetime and another UTC datetime thatвЂ™s 4 hours later. Since JSON doesnвЂ™t have a datetime value weвЂ™ll go ahead and send them as strings. In our case, weвЂ™re meant to provide an array of values вЂ“ a string, two datetime values, and a Boolean true/false. Since itвЂ™s expecting JSON weвЂ™ll have to format our information using JSON syntax. That makes sense because we havenвЂ™t provided those four bits of information that it requires yet from above.

SOLARWINDS API CODE

If we were to send the request as it is we would get a status code of вЂњ500 Internal Server ErrorвЂќ and an error back:

The format is talked about a bit in the SolarWinds wiki and takes a format like the following: /Invoke// The URL weвЂ™re going to use for the request is slightly different now that weвЂ™re using a verb. Set the authentication to Basic Auth, enter your username & password, and click вЂUpdate RequestвЂ™.Change the method from GET to POST and enter the beginning of the URL.The setup thatвЂ™s required is the same that we went through in the last post so IвЂ™ll just list the steps briefly here: Now that we know what need, letвЂ™s move over to Postman to do the work. Since itвЂ™s trivial to come up with a timestamp 2 hours in the future in any programming language it makes sense to set this to false and go ahead and provide unmanage and remanage time stamp values. A relative remanage time would be something like вЂњ00:30:00вЂќ for 30 minutes. The information that SWIS needs to unmanage a device are the netObjectId, the time to start the unmanage period (usually now is good), the remanage time (now + 2 hours, for example) and finally a flag indicating whether or not the remanage time is relative. That вЂњUnmanageвЂќ verb the one weвЂ™ll use to unmanage this device. Expanding that area reveals a long list of properties with the blue icons, generated fields with green icons, navigation properties with chain links, and finally verbs with purple/pink icons. Since the goal is to unmanage a device the first order of business is to expand the Orion namespace so we can get to the Orion.Nodes entity. ThereвЂ™s even some overlap where products have been renamed (e.g., Cirrus renamed to NCM). The more products you have installed the more entries youвЂ™re going to see here.

These are basically folders organizing all the entities that are in SolarWinds. Once youвЂ™ve authenticated you can expand the left dropdown and see that there are dozens of namespaces. For this exercise youвЂ™ll want to make sure you use an account that has at least node management rights because weвЂ™re going to unmanage and remanage a node in the inventory. Either will get you to the same place provided your user has admin privileges.

SOLARWINDS API PASSWORD

Provide the hostname of the SolarWinds server (localhost if youвЂ™re running it on the server itself), and then either provide a username & password or change the вЂњServer TypeвЂќ drop-down to вЂњOrion (v3) ADвЂќ to authenticate with the user youвЂ™re using to log into your machine. Once itвЂ™s installed, launch it and authenticate the way you would if you were logging into the web console. The changes are measured and infrequent and usually involve some kind of improvement/bugfix over the last. You can grab the latest version available even if itвЂ™s a beta. ThatвЂ™s going to allow us to submit SWQL (SolarWinds Query Language) requests to the SWIS (SolarWinds Information Service).

SOLARWINDS API DOWNLOAD

If you havenвЂ™t already, youвЂ™ll want to go and download the Orion SDK which includes a utility called SWQL Studio. This time weвЂ™ll dive in a little deeper and talk about leveraging the many вЂњverbsвЂќ that are available.

SOLARWINDS API SERIES

In the first post in this series I started by going over authentication with the SolarWinds API and sending queries with parameters.

SolarWinds Public Training Class Schedule.

Solarwinds api