topic Re: How to use POST /network-device/location in Controllers

How to use POST /network-device/location

Nathan Sowatskey — Fri, 01 Mar 2019 12:30:10 GMT

The attached image shows the documentation for POST /network-device/location.

The documentation says that it "Associates the given location to the given device".

The actual argument is a NetworkDeviceNIO, not a given location or device.

I can't actually see a "location" field in the NetworkDeviceNIO. The closest is a "snmpLocation".

So, how is this API supposed to be used please?

Many thanks

Nathan

Re: How to use POST /network-device/location

Joe Clarke — Thu, 28 Jul 2016 15:48:56 GMT

I agree this is confusing. However, there is a "location" element in the NetworkDeviceNIO model. So, let's say your location UUID is "d2b063ad-ea9b-43cd-8536-e68aa9d31c66". Create a JSON body for the /network-device/location resource:

{

"id":"1153fb76-06dd-4c61-9aa6-739e3d4ab80f",

"location":"d2b063ad-ea9b-43cd-8536-e68aa9d31c66"

}

Here, id is the device's UUID and location is the location UUID obtained from GET /location.

Re: How to use POST /network-device/location

Nathan Sowatskey — Thu, 28 Jul 2016 15:58:16 GMT

Thank you Joe. I was just being blind, there is a “location” attribute, I just didn’t see it. It is between “type” and “id”.

In my, limited. defence, some of the field names are in bold, and some in grey, so they don’t stand out. As I squint harder, I think that the convention is that the required fields are in bold, and those that are optional are in grey.

Regards

Nathan

Re: How to use POST /network-device/location

Joe Clarke — Thu, 28 Jul 2016 16:00:09 GMT

Yeah, the bold/grey is why I say it's a bit confusing. For the location API, one would expect all I should be able to enter in the model is device ID and location ID.