How to create a API poller proxy in Python using Orion API

This all depends on what you are looking to change.  If you want to assign or unassign specific Application Templates (you mentioned Server & Application Monitor (SAM)  near the beginning), that can be done with the API.  If you want to assign custom properties to either the assigned application or nodes, this can also be done.

But most people "shortcut" this by using Groups.  Here's a (simplified) scenario:

• You have an application template (we'll call it "Custom Application")
• This application needs to be assigned to a set of nodes.
• You create a custom property (for Nodes) called "RunsCustomApp" (True/False) and check the box when the server runs the application.
• You create a Group called "Custom App Servers" and have a Dynamic Query defining membership where "RunsCustomApp" is True.
• You can then assign the "Custom Application" template to the group.
• When nodes move in and out of the group, the application is either assigned or unassigned from the device.

Thanks for the feedback!
I am sorry, but I am not able to follow some details in what you are suggesting (as I am not an experienced user), and would be pleased if you could direct me to the associated documentation and to add some details 

• From your reply my understanding is that my (Python) proxy would be the Custom application to be created. (I have no experience in applying custom applications)
• I will then have to create a Group of nodes ("Custom App Servers") there the nodes have a specific custom property defined and set. I would name the new property myself e.g. "RunsCustomApp".
• There should then be a dynamic membership as to add/remove nodes from the Group which should be controlled by the proxy/application

Thereby the node mapping is achieved and one could then e.g. use maps to present the topology.
However, it is not clear how the status information shall be updated / pushed into SW by the proxy/application.

 KMSigma.SWI  Kevin, can you refer to someone who has created API pollers via the SDK or some documentation with examples.

We thought about opening a support ticket, but they push back on helping with custom scripts!

We don't have any documentation for it.  All the API's docs are up in the GitHub Wiki (and some samples).  I don't think we have any specific for API pollers.

I don't see a section for the API poller.  Can you help point to that specific section of the Github Wiki?

Here is an example adapted from some internal design documents.  I haven't tested this, so take it with a big grain of salt.  If this doesn't work, I'll ask the team that worked on this feature to comment here.

CreateApiPollerFromTemplate allows you to create an API Poller based on a template exported either from an existing API Poller or from the out-of-the-box template library.  But how do you get that template file to begin with?  If you're exporting an existing API Poller to a file (template.xml in the example below), you could use the ExportTemplate verb:

Import-Module SwisPowerShell
 
$hostname = "IP"
$username = "Username"
$plainTextPassword = "***"
$password = $plainTextPassword | ConvertTo-SecureString -AsPlainText -Force
 
$cred = New-Object -typename System.Management.Automation.PSCredential -argumentlist $username, $password
$swis = Connect-Swis -host $hostname -cred $cred

$templateId = 1
$result = Invoke-SwisVerb $swis Orion.APIPoller.Templates ExportTemplate @($templateId)
$exportedTemplate = $result.InnerText
$exportedTemplate | Out-File ".\template.xml"

Once you have a template file to work with, you can import it via the CreateApiPollerFromTemplate verb:

Import-Module SwisPowerShell
 
$hostname = "IP"
$username = "Username"
$plainTextPassword = "***"
$password = $plainTextPassword | ConvertTo-SecureString -AsPlainText -Force
 
$cred = New-Object -typename System.Management.Automation.PSCredential -argumentlist $username, $password
$swis = Connect-Swis -host $hostname -cred $cred
 
$apiPollerTemplate = (Get-Content -Path ".\template.xml" | Out-String)
 
$configuration= @{
    "CredentialType" = "BasicAuth"
    "CredentialID" = "1"
  };
$parameters= @{ };
 
$result = Invoke-SwisVerb $swis "Orion.ApiPoller.ApiPoller" "CreateApiPollerFromTemplate" @("Orion.Nodes", 1, $apiPollerTemplate, $configuration, $parameters)
$apiPollerId = $result.InnerText

 dan_jagnow   Thank you for the response.  This documentation helps a lot.

I was able to get it to work manually through the SWQL studio, but when trying via the PowerShell script I keep getting this message.  I can't figure out what is does not like.

Invoke-SwisVerb : Verb Orion.APIPoller.ApiPoller.CreateApiPollerFromTemplate cannot unpackage parameter 3 of type System.Collections.Generic.Dictionary`2[System.String,System.String]

Initially I was trying to pass in the XML string as it was passed in via SWQL studio and then I changed the $configuration and $parameters to the hash table format you suggested, but it returns the same error.

Here is my code snippet:

$entityType = "Orion.Nodes"
$entityID = 3045
$template = '<?xml version="1.0" encoding="utf-8"?><Template xmlns:xsi="">www.w3.org/.../XMLSchema-instance" xmlns:xsd="">www.w3.org/.../DisplayName><Description /><Created>2024-03-05T04:38:10.3644824Z</Created><Updated>2024-03-05T04:38:10.3644824Z</Updated><Version>1</Version><RequestDetailsCollection><RequestDetails><Url>blah.com</Url><Body /><HttpVerb>Get</HttpVerb><ValueToMonitorCollection><ValueToMonitor><DisplayName>status code</DisplayName><Path>$</Path><ThresholdRule>NotEqualTo</ThresholdRule><WarningThresholdValue xsi:nil="true" /><CriticalThresholdValue>200</CriticalThresholdValue><Type>StatusCode</Type><StringToNumberTransformationRules /><StringToNumberTransformationOtherValues>0</StringToNumberTransformationOtherValues></ValueToMonitor></ValueToMonitorCollection><RequestVariables /><RequestDetailsOrder>0</RequestDetailsOrder></RequestDetails></RequestDetailsCollection><PollingInterval>60</PollingInterval></Template>'

## Variable format option 1
#$configuration = '<ArrayOfKeyValueOfstringstring xmlns:i="">www.w3.org/.../XMLSchema-instance" xmlns="'">schemas.microsoft.com/.../ArrayOfKeyValueOfstringstring>' | ConvertFrom-StringData
#$parameters = '<ArrayOfKeyValueOfstringstring xmlns:i="">www.w3.org/.../XMLSchema-instance" xmlns="'">schemas.microsoft.com/.../ArrayOfKeyValueOfstringstring>' | ConvertFrom-StringData

## Variable format option 2
$configuration = @{
"Name" = $pollerName
"DisplayName" = $pollerName
"Url" = $pollerURL
"VerifySslCertificate" = $true
"UseProxy" = $false
"PollingInterval" = 60
"CredentialType" = "OAuth2Shared"
"CredentialID" = "173"
};

$parameters = @{ };

Invoke-SwisVerb $swis Orion.APIPoller.ApiPoller CreateApiPollerFromTemplate @($entityType, $entityID, $template, $configuration, $parameters)

Internally, the last two parameters for this SWIS verb (configuration and parameters) are of type Dictionary<string, string> in C#.  That means it's a dictionary data structure with a string key and a string value.  When serialized as XML, Microsoft uses ArrayOfKeyValueOfstringstring (see https://learn.microsoft.com/en-us/openspecs/sharepoint_protocols/ms-sadmws/5a8ba9b2-6287-44b4-a8fc-ab88b7d7c3c4).  There's a lot of useful information about working with that kind of data and some examples of what the XML looks like at https://stackoverflow.com/questions/49519253/deserializing-xml-from-soap-call-into-array-of-objects.  See Where are Orion.Credential.CreateCredentials & Orion.Credential.UpdateCredentials for an example of another place this data format is used with the Orion SDK for a different verb.  The XML there should give you a good idea of what this should look like. 

Did you ever get this working?

I'm stuck on same issue.

Hi Daryl. We got it working with Powershell and I later converted it to Python. I'm sure you can finagle this to suit your needs. Note, that it reads a list of url's and uses regex to create the Poller Name based on the text in the URL so that you can mass create API pollers. We had some weirdness where I had to go in and re-select the 'No Auth' for each one (or select the auth, you can also set the auth in the script, but we did not) otherwise they were stuck in 'unknown' status. You can modify the regex as needed. Here is an example of the format of the API list .txt file: 'https://api.corporation.corp/sapi-thing1-events-storage/v1/healthcheckendpoint' and here is the script. Cheers!

Im actually doing this in powershell, I should be able to convert it back.

Thanks

you may want to remove your KEY in the xml

you may want to remove your KEY in the xml