NEnetxms
Objects

Update object auto-bind configuration

Changed on

Update the auto-bind filters of an auto-bind-capable object (Container, Collector, Facility, PowerDomain, CoolingZone, Circuit, Cluster, NetworkMap, Template, Dashboard, BusinessService and business service prototype). Each object supports up to two filter slots; entries in the autoBindFilters array are applied positionally to slots 0, 1, … Within each entry omitted keys are left unchanged; a null or omitted source clears that slot's filter script.

Filter scripts are compiled and validated by default; a compilation failure returns 400 with a diagnostic object. Pass ?validate=false to store work-in-progress or intentionally broken scripts (matches the NXCP "always store" behavior).

This property group applies only to auto-bind-capable object classes; sending it to any other class returns 400.

patch/v1/objects/{object-id}/auto-bind

Request

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

Path parameters

object-idinteger required

Query parameters

validateboolean

When false, skip compilation of filter scripts.

Request body

Response

Auto-bind configuration updated; full updated object returned.

aliasstring

Object alias

categoryinteger

Object category ID

class'AccessPoint' | 'AgentPolicyLogParser' | 'Asset' | 'AssetGroup' | 'AssetRoot' | 'BusinessService' | 'BusinessServiceProto' | 'BusinessServiceRoot' | 'Chassis' | 'Cluster' | 'Condition' | 'Container' | 'CoolingZone' | 'Dashboard' | 'DashboardGroup' | 'DashboardRoot' | 'Facility' | 'Generic' | 'Interface' | 'MobileDevice' | 'Network' | 'NetworkMap' | 'NetworkMapGroup' | 'NetworkMapRoot' | 'NetworkService' | 'Node' | 'NodeLink' | 'PowerDomain' | 'Rack' | 'Report' | 'ReportGroup' | 'ReportRoot' | 'Room' | 'Sensor' | 'ServiceCheck' | 'ServiceRoot' | 'Subnet' | 'Template' | 'TemplateGroup' | 'TemplateRoot' | 'VPNConnector' | 'Zone'
guidstring uuid

Object GUID

idinteger

Object ID

namestring

Object name

timestampstring date-time

Object last change timestamp

timeZonestring nullable

Effective IANA time zone name (own or inherited from a parent object), null if not set.

timeZoneRulestring nullable

POSIX TZ rule of the effective time zone, null if not set.

timeZoneSourceinteger

ID of the parent object the time zone is inherited from, or 0 when the time zone is defined on this object or not set.

status0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

Changes

  • 53fbfac7f424Revision changes
    • 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

  • 2827204d68d9Revision changes
    • warning

      added the new Room enum value to the response property for the response status