LogoLogo
OverviewDemos and ResourcesContact
  • What is Engine?
  • Key Concepts
    • Drivers
    • Modules
    • Systems
    • Zones
    • Settings
    • Interfaces
    • Triggers
  • Security
  • Deployment
    • System Architecture
    • Single Sign-On
      • Configuring Engine for SAML2
      • SAML2 with Azure AD
      • SAML2 with ADFS
      • SAML2 with Auth0
      • SAML2 with GSuite
      • OAuth2
  • Integrations
    • Supported Integrations
    • Directory Services
      • Microsoft Office365
    • IoT
      • Device Drivers
      • Node-RED
      • Azure IOT Hub
    • Location Services
      • Locating Users on a Network
      • SVG Map Creation
      • Cisco CMX
      • Cisco Meraki RTLS
      • Desk Sensors
  • Administration
    • Backoffice
      • Systems
      • Devices
      • Drivers
      • Zones
      • Triggers
      • Metrics
      • Users
      • Domains
        • Applications
  • Developer Guide
    • Development Environment
    • Building Drivers
      • Discovery and Metadata
      • State
      • Scheduling Actions
      • Response Tokenisation
      • Device Drivers
      • SSH Drivers
      • Service Drivers
      • Logic Drivers
      • Testing
      • Live Monitoring
      • Logging
      • Security
      • Utilities and Helpers
    • User Interfaces
      • Composer
      • Virtual Systems
      • Widgets
      • Settings.json
  • API
    • Authentication
    • Control
      • Systems
      • Modules
      • Dependencies
      • Zones
      • Websocket
        • Commands
          • bind
          • unbind
          • exec
          • debug
          • ignore
        • Heartbeat
        • Errors
  • Support
    • Service Desk
Powered by GitBook
On this page
  • Model
  • Search
  • Management
  • Create
  • Retrieve
  • Update
  • Delete
  • Interaction
  • Reload

Was this helpful?

  1. API
  2. Control

Dependencies

PreviousModulesNextZones

Last updated 5 years ago

Was this helpful?

When a driver is loaded into Engine, it becomes a dependency. Dependencies are available as the blueprint from which modules are created. The /dependencies endpoint provide methods to discover, load and update these. For more on the role the drivers play, see:

Model

Attribute

Type

Description

id

string

The dependency's unique ID.

name

string

Human readable name for the dependency.

class_name

string

The Ruby class name of the driver.

module_name

string

The kind of module this instantiates (e.g. Display).

role

string

One of ssh, device, service, or logic.

description

string

Additional information that describes the dependency.

default

string or

integer

A URL or port number that is typical for modules using this.

ignore_connected

boolean

Default state of connectivity monitoring for instances.

settings

object

A JSON object containing configuration shared by all instances.

created_at

integer

Timestamp of creation.

Search

GET https://example.com/api/control/dependencies

List or search for loaded dependencies.

Query Parameters

Name
Type
Description

q

string

A search filter to apply.

limit

integer

(default 20) Max results to return.

offset

integer

The offset within the result set.

role

string

Filter to a specific role.

{
  "total": 1,
  "results": [
    {
      "name": "Pexip Management API",
      "description": "Pexip VMR management",
      "role": "service",
      "default": null,
      "class_name": "::Pexip::Management",
      "module_name": "Meeting",
      "ignore_connected": false,
      "settings": {},
      "created_at": 1562041127
    }
  ]
}

Queries default to searching for any of the entered terms (words). A small query language provides the ability to structure complex queries.

Operator

Action

+

Matches both terms.

`

`

Matches either terms.

-

Negates a single token.

"

Wraps tokens to form a phrase.

( and )

Provide precedence.

~N

Specifies edit distance (fuzziness) after a word.

~N

Specifies slop amount (deviation) after a phrase.

Management

Create

POST https://example.com/api/control/dependencies

Defines a new dependency. The driver this references must be available on the engine nodes running this instance of Engine. Available drivers can be listed by using the discovery endpoint.

Request Body

Name
Type
Description

name

string

class_name

string

module_name

string

role

string

description

string

default

string

ignore_connected

boolean

settings

object

{
  "name": "Pexip Management API",
  "description": "Pexip VMR management",
  "role": "service",
  "default": null,
  "class_name": "::Pexip::Management",
  "module_name": "Meeting",
  "ignore_connected": false,
  "settings": {},
  "created_at": 1562041127
}

Retrieve

GET https://example.com/api/control/dependencies/{id}

Gets dependency information

Path Parameters

Name
Type
Description

id

string

ID of the dependency to retrieve.

{
  "name": "Pexip Management API",
  "description": "Pexip VMR management",
  "role": "service",
  "default": null,
  "class_name": "::Pexip::Management",
  "module_name": "Meeting",
  "ignore_connected": false,
  "settings": {},
  "created_at": 1562041127
}

Update

PUT https://example.com/api/control/dependencies/{id}

Updates dependency metadata.

Path Parameters

Name
Type
Description

id

string

ID of the dependency to update.i

Request Body

Name
Type
Description

name

string

class_name

string

module_name

string

role

string

description

string

default

string

ignore_connected

boolean

settings

object

{
  "name": "Pexip Management API",
  "description": "Pexip VMR management",
  "role": "service",
  "default": null,
  "class_name": "::Pexip::Management",
  "module_name": "Meeting",
  "ignore_connected": false,
  "settings": {},
  "created_at": 1562041127
}

Delete

DELETE https://example.com/api/control/dependencies/{id}

Unloads a driver.

Path Parameters

Name
Type
Description

id

string

ID of the dependency to remove.

Interaction

Reload

POST https://example.com/api/control/dependencies/{id}/reload

Live reloads the latest version of the driver code and updates all modules using this.

Path Parameters

Name
Type
Description

id

string

ID of the dependency to reload.

Drivers