Objects

Update object auto-bind configuration

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

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

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

Changes

Changed in 10 of the 115 revisions of this API.456

    • ●

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

      response-property-enum-value-added

  • ef2ed4fdc37611See the full diff
    • ▲

      response property customAttributes/items/value list-of-types was widened by adding types array and object to media type application/json of response 200

      response-property-list-of-types-widened

    • ○

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

      response-optional-property-added

    • ▲

      the response property ///// became nullable for the status

      response-property-became-nullable

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ▲

      the response property ///// became nullable for the status

      response-property-became-nullable

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      endpoint added

      endpoint-added

    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog