SW Orion API - Need Help Getting Started

FormerMember

I hope this is the right forum to start with.

I'm not super skilled with APIs more broadly but I've done a couple things with them. My tool of choice is PowerShell because that's what I've used in the past and I'm skilled with it.

My immediate goal is to take a list of server names (which are all nodes in Orion by the same name) and schedule an "unmanaged period" ahead of maintenance. This will save me from clicking every server and unmanaging them, then setting the same exact same time period one-by-one. My problem is how to get started with this.

I didn't find a good article in the customer portal/documentation. The best link I found is this swagger UI which is better than nothing, but not far from: Swagger UI (solarwinds.github.io). I feel like there's got to be better documentation for the API than this but I haven't found it.

What I think I need is the following questions answered:

1. How do I authenticate to my Orion instance's API? We use SAML authentication, so basic auth isn't going to work here. I need this answered first before I can truly think about anything else.
2. I found the URI `/Invoke/Orion.Nodes/Unmanage` in the Swagger resource. But it has an odd attribute - isRelative. But 0 documentation on what this means. I assume it has something to do with timezones but it's not obvious. Is there any exhaustive documentation on the API?
3. The same JSON references a netObjectId property. I'm assuming this is the same ID that shows up in a browser's address bar (e.g. `/Orion/NetPerfMon/NodeDetails.aspx?NetObject=N:20`). Is there a URI to return all nodes in the Orion environment and their objectIds? Or how would I go about getting this netObjectId property so I can properly unmanage nodes? Maybe I'm processing the logic badly/incompletely.

adam.beedell

Hi there,

1) It's just basic at the moment, sorry that's all that's around. There's a post in the features request section to resolve that. Expect it to arrive in an update at some point proportional to how many people want it. Personally I've got SAML + a service account with a self-destruct rule on it, that was quite fun to write.

2.It's about time going forward vs pure hours.

3.The Query resource, writing a statement to select all node IDs. That set NetObjectID supports IDs from other tables.

Sounds like you've missed some stuff. There's a book on the topic being written with some intro PDFs on here. The official github's got plenty for most needs. There's official classes on youtube, loads of posts on the topic in here, have another round of searching and you should find plenty around. The unmanage script has been written probably a dozen times on here already.