Waypoint Job list
Warning
This content is part of the legacy version of Waypoint that is no longer actively maintained. For additional information on the new vision of Waypoint, check out this blog post and the HCP Waypoint documentation.
Command: waypoint job list
List all jobs in Waypoint
Usage
Usage: waypoint job list [options]
List known jobs from Waypoint server. Options to filter job list by project, workspace, target runner, pipeline, and pipeline run.
Global Options
-plain
- Plain output: no colors, no animation. The default is false.-app=<string>
(-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.-project=<string>
(-p
) - Project to target.-workspace=<string>
(-w
) - Workspace to operate in.
Operation Options
-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.
Command Options
-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. Includes all fields for jobs. The default is false.-verbose
- Output more details for a job. The default is false.-limit=<int>
- If set, will limit the number of jobs to list.