NEnetxms
Object Tools

Create a new object tool

Changed on

Create a new object tool. The server assigns the tool ID and GUID. Requires SYSTEM_ACCESS_MANAGE_TOOLS.

post/v1/object-tools

Request

  • Base URL
    http://127.0.0.1:8000
  • URL
    http://127.0.0.1:8000/v1/object-tools
  • Auth
    HTTP bearer

Request body

namestring required

Tool name

type'action' | 'snmp-table' | 'agent-list' | 'url' | 'command' | 'server-command' | 'file-download' | 'server-script' | 'agent-table' | 'ssh-command' required

Type of object tool

datastring

Tool-specific data (command line, script name, URL template, etc.)

descriptionstring
filterstring
confirmationMessagestring
commandNamestring
commandShortNamestring
iconstring uuid

UUID of an existing image library entry; omit or use null UUID for no icon

remotePortinteger
remoteHoststring
applicableClassesinteger

Bitmask of applicable object classes. Bit 0 (1) = Node, bit 1 (2) = Interface, bit 2 (4) = Sensor, bit 3 (8) = Access point. Defaults are applied if 0 or missing: URL tools default to all classes, others to Node. Non-Node bits are stripped for tool types other than server-script, url and ssh-command.

aclinteger[]

User and group IDs allowed to execute this tool. Replaces the existing ACL on PUT. Send an empty array to remove all entries.

Response

Object tool created.

idinteger

Tool ID

namestring

Tool name

type'action' | 'snmp-table' | 'agent-list' | 'url' | 'command' | 'server-command' | 'file-download' | 'server-script' | 'agent-table' | 'ssh-command'

Type of object tool

confirmationMessagestring

Confirmation message shown to user

commandNamestring

Full command name

commandShortNamestring

Short command name

remotePortinteger

Remote port for TCP tunnel

remoteHoststring

Remote host for TCP tunnel

applicableClassesinteger

Bitmask of object classes the tool is applicable to. Bit 0 (1) = Node, bit 1 (2) = Interface, bit 2 (4) = Sensor, bit 3 (8) = Access point. Only server-script and URL tools may include bits other than Node.

datastring

Tool-specific data

descriptionstring

Tool description

filterstring

Tool filter (matching OID for SNMP tools)

iconstring uuid

UUID of the icon image in the image library; absent when no icon is set

aclinteger[]

User and group IDs allowed to execute this tool. Only present when the caller has SYSTEM_ACCESS_MANAGE_TOOLS rights.

Changes

  • 69bf641bba09Revision changes
    • breaking

      removed the enum value internal of the request property

    • info

      removed the internal enum value from the //// response property for the response status

  • 30e75dc6a94cRevision changes
    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional request property //

    • info

      added the new optional request property

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property / to the response with the status