Page History

...

We can also manage nodes using the API.

Operation

Method

URL

Response

Example

Get Nodes

GET

http://host/en/omk/admin/api/v2/nodes.json

http://uburnto.opmantek.net/en/omk/admin/api/v2/nodes.json?requestData=undefined&page=1&per_page=25&sort_by=name&order=asc

Get Node

GET

http://host/en/omk/admin/api/v2/nodes/{node_uuid}.json

http://uburnto.opmantek.net/en/omk/admin/api/v2/nodes/86a82b4c-6ef6-4691-8c8c-1fc8da334d6f.json

Create Node

POST

http://host/en/omk/admin/api/v2/nodes.json

The node in json from the recently node created, including the UUID

http://uburnto.opmantek.net/en/omk/admin/api/v2/nodes.json

Code Block
{ "

configuration

activated":
{
"

netType

NMIS": "

default

1",
"

polling_policy

opConfig": "

default

0",
"

port

opEvents": "

161

1"
},
"

collect

configuration":

1,"threshold


{
"active":

1

 null,"

roleType

authkey": "

default

","

ping

authpassword":

1

 "","

group

authprotocol":

"NMIS9"

 null,"

host

businessService":

"asgard.opmantek.net

 null,
"collect": 1,"community": "","

location

context":

null

 "","customer": null,"

businessService

group":

null

 "NMIS9",
"

notes

host": "asgard.opmantek.net","host_backup": "","

active

location": null,
"

community

netType": "default","

wmiusername

nettype":

""

 null,"

wmipassword

node_context_name": "","

username

node_context_url": "","

context

notes": "",
"

authpassword

ping":

""

1,"

authkey

polling_policy": "default","

authprotocol

port":

null

 "161","

privpassword

privkey": "","

privkey

privpassword": "",
"privprotocol": null,"

serviceStatus

remote_connection_name":

null,

nettype

:null

,"

roletype":null,"node_context_name

remote_connection_url": "","

node_context_url

roleType": "default",
"

remote_connection_name

roletype":

""

 null,"

remote_connection_url

serviceStatus":

""}

 null,"

activated

threshold":

{

1,"

opEvents

username": "

1

","

opConfig

wmipassword": "

0

","

NMIS

wmiusername": "

1

"
},

"uuid":null,"


"current_user_privileges":
{
"

update

delete": true,
"

delete

update": true
},
"

name

friendly_addresses": "

test

",
"friendly_

addresses

aliases": "",
"

friendly_aliases

name": "test",
"uuid": null
}

Update Node

PUT

http://host/en/omk/admin/api/v2/nodes/{node_uuid}.json

http://uburnto.opmantek.net/en/omk/admin/api/v2/nodes/b56ba595-69e7-4702-9fe5-49512e1340b0.json

Code Block
{ "

configuration

activated":
    {

"netType


        "NMIS": "

default

1",

"polling_policy


        "opConfig": "

1_minute

0",

"port


        "opEvents": "

161","collect":1,"threshold":1,"roleType":"access","ping":1,"group":"EXSI","active":1,"addresses":[

1"
    },
    "addresses":
    [],
    "aliases":
    [],
    "cluster_id": "a515c63a-0d11-4bcb-a402-39a4600aebb9",
    "configuration":
    {
        "active": 1,
        "addresses":
        [
            "192.168.88.13"
        ],
        "aliases":
        [],
        "authkey": "","authpassword": "","authprotocol": "md5","businessService": null,"cbqos": "none",
        "collect": 1,"community": "OMKRead","context": "","customer": "Opmantek","depend":
        [],
        "display_name": "

Opmantek

","

depend

group":

[],"display_name":"

 "EXSI","host": "castor.opmantek.net","host_backup": "","ip_protocol": "IPv4",
        "location": "Cloud","max_msg_size": 1472,"max_

repetitions":0,"model":"automatic"

repetitions": 0,"model": "automatic",
        "netType": "default","nettype": null,"node_context_name": "Node Context",
        "node_context_url": "https://somelink.

com/map/thing/","notes":"

com/map/thing/","notes": "","ping": 1,
        "polling_policy": "1_minute","port": "161","privkey": "","privpassword": "",
        "privprotocol": "des","remote_connection_name": "SSH to Node","remote_connection_

url":"ssh://$host"

url": "ssh://$host",
        "roleType": "access","roletype": null,"serviceStatus": "Testing","services":
        [],
        "sysDescr": "VMware ESXi 6.7.0 build-17167734

VMware, Inc. x86_64","timezone":0,"username":"","version":"snmpv2c","webserver":0,"wmipassword":"","wmiusername":"","nettype":null,"roletype":null},"activated":{"opEvents":"1","opConfig":"0","NMIS":"1"},"uuid":"b56ba595-69e7-4702-9fe5-49512e1340b0",

VMware, Inc. x86_64","threshold": 1,"timezone": 0,
        "username": "","version": "snmpv2c","webserver": 0,"wmipassword": "","wmiusername": ""
    },
    "current_user_privileges":

{"update":0,"delete":0},"addresses":[],"aliases":[],"cluster_id":"a515c63a-0d11-4bcb-a402-39a4600aebb9",


    {
        "delete": 0,
        "update": 0
    },
    "friendly_addresses": "192.168.88.13",
    "friendly_aliases":

"",

 "",
    "name": "Castor",
    "node_local": "Remote",
    "overrides":
    {},
    "server_name": "fulla",
    "unknown":
    {},
    "uuid": "b56ba595-69e7-4702-9fe5-49512e1340b0"
}

Delete Node

DELETE

http://host/en/omk/admin/api/v2/nodes/{node_uuid}.json

http://uburnto.opmantek.net/en/omk/admin/api/v2/nodes/b56ba595-69e7-4702-9fe5-49512e1340b0.json

Important: All this methods are authenticated.

...

Space shortcuts

Child pages

Versions Compared

Old Version 5

New Version 6

Key