PuppetDB 4.3: Fact-names endpoint

This version of PuppetDB is not included in Puppet Enterprise. The latest version of PE includes PuppetDB 4.2.

The /fact-names endpoint can be used to retrieve all known fact names.

/pdb/query/v4/fact-names

This will return an alphabetical list of all known fact names, including those which are known only for deactivated nodes.

URL parameters

  • query: optional. A JSON array containing the query in prefix notation (["<OPERATOR>", "<FIELD>", "<VALUE>"]). See the sections below for the supported operators and fields. For general info about queries, see our guide to query structure.

If a query parameter is not provided, all results will be returned.

Response format

The response will be in application/json, and will contain an alphabetical JSON array containing fact names. Each fact name will appear only once, regardless of how many nodes have that fact.

[<fact>, <fact>, ..., <fact>, <fact>]

Examples

Using curl from localhost:

curl -X GET http://localhost:8080/pdb/query/v4/fact-names

["kernel", "operatingsystem", "osfamily", "uptime"]

Paging

This query endpoint supports paged results via the common PuppetDB paging URL parameters. For more information, please see the documentation on paging.

↑ Back to top