PuppetDB 1.4 » API » v1 » Querying Status

This version of PuppetDB is not included in Puppet Enterprise. The latest version of PE includes PuppetDB 4.0. A newer version is available; see the version menu above for details.


GET /v1/status/nodes/<NODE>

This will return status information for the given node. There must be an Accept header matching application/json.

Response Format

Node status information will be returned in a JSON hash of the form:

{"name": <node>,
 "deactivated": <timestamp>,
 "catalog_timestamp": <timestamp>,
 "facts_timestamp": <timestamp>}

If the node is active, “deactivated” will be null. If a catalog or facts are not present, the corresponding timestamps will be null.

If no information is known about the node, the result will be a 404 with a JSON hash containing an “error” key with a message indicating such.


Using curl from localhost:

curl 'http://localhost:8080/status/nodes/<node>'

Where is the name of the node whose status you wish to check.

↑ Back to top