Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Authentication is required to access all methods below.

Public API for

...

opCharts Inventory "http[s]://server/omk/opCharts/v2/"

We can view Enterprise Services below using these endpoints - http[s]://server/omk/opCharts/v2/inventory

...

Not all requests will use all request modifiers.

Query Parameter

Possible Values

properties

Array of property names. If provided only the properties specified will be returned (instead of the whole document.

eg: properties=["configuration.customer", "configuration.group"]

By default the nodes UUID is returned by default if no properties are given

page(int) Which page of the requested document to returned
limit(int) How many results are returned, defaults to 25
filter

Array of key=value pairs, but coded in an array. Applied to the list of results in the order they are given. If an application key is provided that will be applied first.

eg: filter={"configuration.group":"NMIS8","catchall.data.nodestatus": "reachable"} (which is "configuration.group"="NMIS8" AND "catchall.data.nodestatus"="reachable" )

Examples of how to use the request modifiers can be found in the response blocks below.  In general, the queries will look something like this: 

...

Similar requests and descriptions with subconcepts

RequestResponse
GET HTTP://server/omk/opCharts/v2/inventory/interface.json?limit=50

Top 50 elements sorted by nodes.name

("_id" and "nodes.uuid")

GET HTTP://server/omk/opCharts/v2/inventory/interface.json?limit=50&page=2

Top NEXT 50 elements sorted by nodes.name

("_id" and "nodes.uuid")

GET HTTP://server/omk/opCharts/v2/inventory/interface.json?limit=50&properties=["nodes.name"]

Top 50 elements sorted by nodes.name

("_id" , "nodes.uuid", "nodes.name")

GET HTTP://server/omk/opCharts/v2/inventory/interface.json?limit=50&page=2&properties=["inventory.data"]

Top NEXT 50 elements sorted by nodes.name

("_id" , "nodes.uuid", "inventory.data")

Similar requests and descriptions with inventory id

RequestResponse
GET HTTP://server/omk/opCharts/v2/inventory/63195a0341073d2dd339ce82.jsonRaw inventory element with given object id
GET HTTP://server/omk/opCharts/v2/inventory/63195a0341073d2dd339ce82.json?properties=["inventory.data"]

Raw inventory element with given object id

("_id", "inventory.data" and "nodes.uuid")