Skip to content

Latest commit

 

History

History
50 lines (31 loc) · 1.4 KB

fact-names.markdown

File metadata and controls

50 lines (31 loc) · 1.4 KB
Raw
title layout canonical
PuppetDB 3.1 » API » v4 » Querying Fact Names
default
/puppetdb/latest/api/query/v4/fact-names.html

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 the page on 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.