Forming orchestrator API requests
The orchestrator API accepts well-formed HTTPS requests and requires authentication.
URIpath following the pattern:
DNS: Your PE console host's DNS name. You can use
localhost, manually enter the DNS name, or use a
puppetcommand (as explained in Using example commands).
ENDPOINT: One or more sections specifying the endpoint, such as
jobs. Some endpoints require additional sections, such as POST /command/deploy.
GET https://$(puppet config print server):8143/orchestrator/v1/inventory GET https://localhost:8143/orchestrator/v1/inventory GET https://puppet.example.dns:8143/orchestrator/v1/inventory
To form a complete curl command, you need to provide appropriate curl arguments, authentication, and you might need to supply the content type and/or additional parameters specific to the endpoint you are calling.
For general information about forming curl commands, authentication in commands, and Windows modifications, go to Using example commands.
Orchestrator API authentication
You must authenticate orchestrator API requests with user authentication tokens. For instructions on generating, configuring, revoking, and deleting authentication tokens in PE, go to Token-based authentication.
puppet-access show, such as:
auth_header="X-Authentication: $(puppet-access show)" uri="https://$(puppet config print server):8143/orchestrator/v1/jobs" curl --insecure --header "$auth_header" GET "$uri"
auth_header="X-Authentication: <TOKEN>" uri="https://$(puppet config print server):8143/orchestrator/v1/jobs" curl --insecure --header "$auth_header" GET "$uri"