NEnetxms
Objects

Get node agent communication configuration

Changed on

Return the node's NetXMS agent communication settings (the same shape accepted by the matching PATCH). The sharedSecret is included only when the caller has modify or read-credentials access to the object.

This property group applies to Node objects only; requesting it for any other object class returns 400.

get/v1/objects/{object-id}/agent

Request

  • Base URL
    http://127.0.0.1:8000
  • URL
    http://127.0.0.1:8000/v1/objects/{object-id}/agent
  • Auth
    HTTP bearer

Path parameters

object-idinteger required

Response

Agent communication configuration.

portinteger

Agent TCP port.

proxyinteger nullable

ID of the node used as agent proxy, or 0 for no proxy.

sharedSecretstring nullable

Agent shared secret (write-only).

forceEncryptionboolean

Require encryption for agent communication.

tunnelOnlyboolean

Accept agent connections only through an established agent tunnel.

cacheMode'default' | 'on' | 'off'

Agent-side DCI value caching mode.

compressionMode'default' | 'enabled' | 'disabled'

Agent communication protocol compression mode.

certificateMappingMethod'subject' | 'publicKey' | 'commonName' | 'templateId'

Method used to map the agent's certificate to this node for authentication.

certificateMappingDatastring nullable

Certificate mapping data (interpretation depends on certificateMappingMethod). For publicKey method, accepts SHA-256 fingerprint of DER encoded SubjectPublicKeyInfo, hex encoded DER public key, or PEM encoded public key or certificate; always stored and returned as fingerprint (64 hex characters).

Changes