Puppet HTTP API: Node

This version is out of date. For current versions, see Puppet packages and versions.
Sections

Node

The node endpoint is used by the puppet agent to get basic information about a node. The returned information includes the node name and environment, and optionally any classes set by an External Node Classifier and a hash of parameters which may include the node’s facts. The returned node may have a different environment from the one given in the request if Puppet is configured with an ENC.

Find

Retrieve data for a node

GET /:environment/node/:certname

Supported HTTP Methods

GET

Supported Response Formats

PSON

Examples

> GET /production/node/mycertname HTTP/1.1
> Accept: pson, b64_zlib_yaml, yaml, raw

< HTTP/1.1 200 OK
< Content-Type: text/pson
< Content-Length: 4630

{
  "document_type":"Node",
  "data":{
    "name":"thinky.corp.puppetlabs.net",
    "parameters":{
      "architecture":"amd64",
      "kernel":"Linux",
      "blockdevices":"sda,sr0",
      "clientversion":"3.3.1",
      "clientnoop":"false",
      "environment":"production",
      ...
    },
    "environment":"production"
  }
}

Schema

Returned node objects conform to the node schema.

See an issue? Please file a JIRA ticket in our [DOCUMENTATION] project
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.