Dependencies
Last updated
Last updated
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:
GET https://example.com/api/control/dependencies
List or search for loaded dependencies.
Queries default to searching for any of the entered terms (words). A small query language provides the ability to structure complex queries.
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.
GET https://example.com/api/control/dependencies/{id}
Gets dependency information
PUT https://example.com/api/control/dependencies/{id}
Updates dependency metadata.
DELETE https://example.com/api/control/dependencies/{id}
Unloads a driver.
POST https://example.com/api/control/dependencies/{id}/reload
Live reloads the latest version of the driver code and updates all modules using this.
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
| 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.
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.
name
string
class_name
string
module_name
string
role
string
description
string
default
string
ignore_connected
boolean
settings
object
id
string
ID of the dependency to retrieve.
id
string
ID of the dependency to update.i
name
string
class_name
string
module_name
string
role
string
description
string
default
string
ignore_connected
boolean
settings
object
id
string
ID of the dependency to remove.
id
string
ID of the dependency to reload.
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.