The Node endpoint of the Puppet Master REST API returns static data that is used to compile catalogs for a given node name. The endpoint does not return any real-time information about nodes.
If you are storing Node information in PuppetDB, node status can be retrieved using the
/nodes endpoint of that service:
This endpoint will provide: the last timestamp a node successfully contacted the master and retrieved facts, the last timestamp the master successfully compiled a catalog for the node, and the last timestamp that the node submitted a report to the master after applying a catalog. The
/reports endpoint can be used to determine the success or failure of a particular run.
For real-time information on the status of a node, you will need to use an orchestration framework. MCollective has a
puppet-agent plugin that can return the status of the Puppet agent on nodes:
mco puppet status command will return information such as which nodes have the puppet service running and whether the puppet service is idling or applying a catalog.