PuppetDB 1.5 » API » v1 » Querying Status

Included in Puppet Enterprise 3.2. A newer version is available; see the version menu above for details.

Routes

GET /v1/status/nodes/<NODE>

This will return status information for the given node.

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 'http://localhost:8080/status/nodes/<node>'

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

↑ Back to top