A new platform for documentation and tutorials is launching soon.
We are migrating Waypoint documentation into HashiCorp Developer, our new developer experience.
»Waypoint Job list
waypoint job list
List all jobs in Waypoint
waypoint job list [options]
List known jobs from Waypoint server. Options to filter job list by project, workspace, target runner, pipeline, and pipeline run.
-plain- Plain output: no colors, no animation. The default is false.
-a) - App to target. Certain commands require a single app target for Waypoint configurations with multiple apps. If you have a single app, then this can be ignored.
-p) - Project to target.
-w) - Workspace to operate in.
-label=<key=value>- Labels to set for this operation. Can be specified multiple times.
-local- True to use a local runner to execute the operation, false to use a remote runner. If unset, Waypoint will automatically determine where the operation will occur, defaulting to remote if possible.
-remote-source=<key=value>- Override configurations for how remote runners source data. This is specified to the data source type being used in your configuration. This is used for example to set a specific Git ref to run against.
-var=<key=value>- Variable value to set for this operation. Can be specified multiple times.
-var-file=<string>- HCL or JSON file containing variable values to set for this operation. If any ".auto.wpvars" or ".auto.wpvars.json" files are present, they will be automatically loaded.
-state=<string>- List jobs that only match the requested state. Can be repeated multiple times. One possible value from: Success, Error, Running, Waiting, Queued, Unknown.
-target-runner-id=<string>- List jobs that were only assigned to the target runner by id.
-target-runner-label=<key=value>- List jobs that were only assigned to the target runner by labels. Can be repeated multiple times.
-pipeline-id=<string>- List jobs initiated by the specific pipeline, look up by pipeline ID.
-pipeline-name=<string>- List jobs initiated by the specific pipeline, look up by pipeline owner.
-run=<int>- List jobs initiated by the specific pipeline run, only valid used together with -pipeline.
-desc- Output the list of jobs from newest to oldest. The default is false.
-json- Output the list of jobs as json. The default is false.
-limit=<int>- If set, will limit the number of jobs to list.