Puppet HTTP API: Facts

Facts

The facts endpoint allows setting the facts for the specified node name.

Save

Store facts for a node. The request body should contain JSON-formatted facts.

PUT /puppet/v3/facts/:nodename?environment=:environment

Supported HTTP Methods

PUT

Supported Format(s)

application/json, text/pson

Parameters

None

Example

  • Note: list of facts was shortened for readability.

  • Note: JSON was formatted for readability.

    PUT /puppet/v3/facts/elmo.mydomain.com?environment=env Content-Type: application/json

    { “name”: “elmo.mydomain.com”, “values”: { “architecture”: “x86_64”, “kernel”: “Darwin”, “domain”: “local”, “macaddress”: “70:11:24:8c:33:a9”, “osfamily”: “Darwin”, “operatingsystem”: “Darwin”, “facterversion”: “1.7.2”, “fqdn”: “elmo.mydomain.com”, }, “timestamp”: “2013-09-09 15:49:27 -0700”, “expiration”: “2013-09-09 16:19:27 -0700” }

    HTTP/1.1 200 OK Content-Type: application/json

Schema

The representation of facts contained in a PUT body, should adhere to the facts schema.