v51

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-01245104440.0 KB

Data Collection

Create data collection item

Create a new data collection item on the object. The DCI type is selected by the type property in the request body (item for a single-value DCI or table for a table DCI, default item). The server assigns the DCI id and returns the full created definition. Enumeration properties accept either symbolic names or raw numeric codes.

post/v1/objects/{object-id}/data-collection/configuration

Path parameters

object-idinteger required

Object ID

Request body

idinteger

DCI ID (assigned by the server)

guidstring uuid

Globally unique DCI identifier

type'item' | 'table'

DCI type. Selected at creation; cannot be changed afterwards.

namestring

Metric/parameter name (required on create)

descriptionstring

Human-readable DCI description

origin'internal' | 'nxagent' | 'snmp' | 'websvc' | 'push' | 'winperf' | 'smclp' | 'script' | 'ssh' | 'mqtt' | 'driver' | 'modbus' | 'ethernetip' | 'cloud' | 'otlp'

Data origin

status'active' | 'disabled' | 'unsupported'

DCI status

dataType'int32' | 'uint32' | 'int64' | 'uint64' | 'string' | 'float' | 'null' | 'counter32' | 'counter64'

Data type (single-value DCI only)

transformedDataType'int32' | 'uint32' | 'int64' | 'uint64' | 'string' | 'float' | 'null' | 'counter32' | 'counter64'

Data type after transformation (single-value DCI only)

deltaCalculation'none' | 'simple' | 'averagePerSecond' | 'averagePerMinute'

Delta calculation method (single-value DCI only)

pollingScheduleType'default' | 'custom' | 'advanced'

Polling schedule type

pollingIntervalstring

Polling interval expression (used when pollingScheduleType is custom)

retentionType'default' | 'custom' | 'none'

Data retention type

retentionTimestring

Retention time expression (used when retentionType is custom)

systemTagstring

userTagstring

commentsstring

transformationScriptstring

NXSL transformation script source

sourceNodeinteger

Source (proxy) node ID, or 0 to disable

snmpPortinteger

snmpVersioninteger

snmpContextstring

snmpRawValueType'none' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'double' | 'ipAddr' | 'macAddr' | 'ip6Addr'

SNMP raw value interpretation (single-value DCI only)

multiplierinteger

unitNamestring

mappingTableIdinteger

sampleCountinteger

predictionEnginestring

allThresholdsRearmEventinteger

aiHintstring

aggregationDisabledboolean

hourlyRetentioninteger

dailyRetentioninteger

instanceDiscoveryMethod'none' | 'agentList' | 'agentTable' | 'snmpWalkValues' | 'snmpWalkOids' | 'script' | 'winperf' | 'webService' | 'internalTable' | 'smclpTargets' | 'smclpProperties' | 'push' | 'otlp'

instanceDiscoveryDatastring

instanceFilterstring

NXSL instance filter script source

instanceNamestring

instanceRetentionTimeinteger

perfTabSettingsstring

accessListinteger[]

Per-DCI access list (user/group IDs)

templateIdinteger

templateItemIdinteger

Response

Data collection item created

idinteger

DCI ID (assigned by the server)

guidstring uuid

Globally unique DCI identifier

type'item' | 'table'

DCI type. Selected at creation; cannot be changed afterwards.

namestring

Metric/parameter name (required on create)

descriptionstring

Human-readable DCI description

origin'internal' | 'nxagent' | 'snmp' | 'websvc' | 'push' | 'winperf' | 'smclp' | 'script' | 'ssh' | 'mqtt' | 'driver' | 'modbus' | 'ethernetip' | 'cloud' | 'otlp'

Data origin

status'active' | 'disabled' | 'unsupported'

DCI status

dataType'int32' | 'uint32' | 'int64' | 'uint64' | 'string' | 'float' | 'null' | 'counter32' | 'counter64'

Data type (single-value DCI only)

transformedDataType'int32' | 'uint32' | 'int64' | 'uint64' | 'string' | 'float' | 'null' | 'counter32' | 'counter64'

Data type after transformation (single-value DCI only)

deltaCalculation'none' | 'simple' | 'averagePerSecond' | 'averagePerMinute'

Delta calculation method (single-value DCI only)

pollingScheduleType'default' | 'custom' | 'advanced'

Polling schedule type

pollingIntervalstring

Polling interval expression (used when pollingScheduleType is custom)

retentionType'default' | 'custom' | 'none'

Data retention type

retentionTimestring

Retention time expression (used when retentionType is custom)

systemTagstring

userTagstring

commentsstring

transformationScriptstring

NXSL transformation script source

sourceNodeinteger

Source (proxy) node ID, or 0 to disable

snmpPortinteger

snmpVersioninteger

snmpContextstring

snmpRawValueType'none' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'double' | 'ipAddr' | 'macAddr' | 'ip6Addr'

SNMP raw value interpretation (single-value DCI only)

multiplierinteger

unitNamestring

mappingTableIdinteger

sampleCountinteger

predictionEnginestring

allThresholdsRearmEventinteger

aiHintstring

aggregationDisabledboolean

hourlyRetentioninteger

dailyRetentioninteger

instanceDiscoveryMethod'none' | 'agentList' | 'agentTable' | 'snmpWalkValues' | 'snmpWalkOids' | 'script' | 'winperf' | 'webService' | 'internalTable' | 'smclpTargets' | 'smclpProperties' | 'push' | 'otlp'

instanceDiscoveryDatastring

instanceFilterstring

NXSL instance filter script source

instanceNamestring

instanceRetentionTimeinteger

perfTabSettingsstring

accessListinteger[]

Per-DCI access list (user/group IDs)

templateIdinteger

templateItemIdinteger