1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
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 /puppet/v3/node/:certname?environment=:environment&transaction_uuid=:transaction_uuid&configured_environment=:environment
### Supported HTTP Methods
GET
### Supported Response Formats
`application/json`
### Parameters
One parameter should be provided to the GET:
- `transaction_uuid`: a transaction uuid identifying the entire transaction (shows up in the report as well)
An optional parameter can be provided to the GET to notify a node classifier that the client requested a specific
environment, which might differ from what the client believes is its current environment:
- `configured_environment`: the environment configured on the client
### Examples
> GET /puppet/v3/node/mycertname?environment=production&transaction_uuid=aff261a2-1a34-4647-8c20-ff662ec11c4c&configured_environment=production HTTP/1.1
> Accept: application/json
< HTTP/1.1 200 OK
< Content-Type: application/json
< Content-Length: 4630
{
"name":"thinky.corp.puppetlabs.net",
"parameters":{
"architecture":"amd64",
"kernel":"Linux",
"blockdevices":"sda,sr0",
"clientversion":"3.3.1",
"clientnoop":"false",
"environment":"production",
...
},
"environment":"production"
}
Schema
------
A node response body conforms to
[the node schema.](../schemas/node.json)
|
