PuppetDB 1.2 » API » v1 » Querying Facts
Querying facts occurs via an HTTP request to the
/facts
REST endpoint.
Query format
Facts are queried by making a request to a URL in the following form:
The HTTP request must conform to the following format:
- The URL requested is
/facts/<node>
- A
GET
is used. - There is an
Accept
header containingapplication/json
.
The supplied <node>
path component indicates the certname for which
facts should be retrieved.
Response format
Successful responses will be in application/json
. Errors will be returned as
non-JSON strings.
The result is a JSON object containing two keys, “name” and “facts”. The “facts” entry is itself an object mapping fact names to values:
{"name": "<node>",
"facts": {
"<fact name>": "<fact value>",
"<fact name>": "<fact value>",
...
}
}
If no facts are known for the supplied node, an HTTP 404 is returned.
Example
curl -H "Accept: application/json" 'http://localhost:8080/facts/<node>'
Where <node>
is the name of the node from which you wish to retrieve facts.
For example:
curl -X GET -H 'Accept: application/json' http://puppetdb:8080/facts/a.example.com
{"name": "a.example.com",
"facts": {
"operatingsystem": "Debian",
"ipaddress": "192.168.1.105",
"uptime_days": "26 days"
}
}