PuppetDB 1 » Spec » Querying Status

Query Format

Node status can be queried by making an HTTP GET request to /status/nodes/<node>, specifying that the request accepts 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.

Example

Using curl from localhost:

curl -H "Accept: application/json" 'http://localhost:8080/status/nodes/<node>'

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

↑ Back to top