Node classifier endpoints
A newer version is available; see the version menu above for details.
Node classifier v1 API endpoints
This page lists the endpoints for the node classifier v1 API. For general information about forming HTTP requests to the API, see the forming requests page.
Note: In addition to the endpoints on this page, there are some endpoints that you can use to check the health of the node classifier service. These are available through the status API documentation.
groups endpoint is used to create, read, update, and delete groups.
A group belongs to an environment, applies classes (possibly with parameters), and matches nodes based on rules.
Because groups are so central to the classification process, this endpoint is where most of the action is.
groupsendpoint page for detailed information. To validate a group object without modifying the database in any way, use the
validateendpoint. To translate a rule condition into the equivalent PuppetDB query, use the
rulesendpoint. To erase all node groups and replace them with an imported list of groups, use the
classes endpoint is used to retrieve a list of known classes within a given environment.
The output from this endpoint is especially useful for creating new node groups, which usually contain a reference to one or more classes.
The node classifier gets its information about classes from Puppet, so this endpoint should not be used to create, update, or delete them.
classified endpoint takes a node name and a set of facts and returns information about how that node should be classified.
The output can help you test your classification rules.
classificationendpoint page for detailed information.
commands endpoint condenses common workflows into simplified endpoints.
See the commands endpoint page for more detailed information.
environments endpoint returns information about environments.
The output will either tell you which environments are available or whether a named environment exists.
The output can be helpful when creating new node groups, which must be associated with an environment.
The node classifier gets its information about environments from Puppet, so this endpoint should not be used to create, update, or delete them.
environmentsendpoint page for detailed information.
nodes endpoint returns the check-in history for a given node or for all nodes.
See the nodes endpoint page for more detailed information.