Collector REST API Requests

Thanks.  The script is successfully setting one-time upgrades for the collectors.

It's a JSON object that should include the following fields: majorVersion, minorVersion, startEpoch, description. 

So if you're trying to add a one time upgrade to 27.003, it might look like this:

{"majorVersion":27,"minorVersion": 3,"startEpoch": 1538420400,"description":"upgrading to the 27003"}

What is the value that 'onetimeUpgradeInfo' should be set to?  I tried setting it to '27003' (as an integer), and the call comes back as 'Invalid json body'.

{
    "collectorGroupName":  null,
    "description":  "lsfregprd-Collector for vpc-0e4ddd0f271668f34",
    "onetimeUpgradeInfo":  27003,
    "enableFailBack":  true,
    "suppressAlertClear":  false,
    "escalatingChainId":  3,
    "backupAgentId":  0,
    "enableFailOverOnCollectorDevice":  false,
    "collectorGroupId":  null,
    "resendIval":  0
}

Hey Phil,

You can actually do all of those with v1 of the API (via onetimeUpgradeInfo, automaticUpgradeInfo, and customProperties fields, respectively), it's just cumbersome to update the Collector via PUT. With v2 of our REST API, which is about to be released, we'll offer update via PATCH, which should make all three of those actions significantly easier. The v1 API docs can probably also use more detail regarding manipulating those three fields - I can update those. 

Thanks,

Sarah