LIST
~~~~
-**list** [--no-headers] [--separator=*SEPARATOR*]
-[-o *[+]FIELD,...*]
+| **list** [\--no-headers] [\--separator=*SEPARATOR*]
+| [-o *[+]FIELD,...*] [\--filter] [job-id...]
Lists the jobs and their status. By default, the job id, job
status, and a small job description is listed, but additional
The ``-o`` option takes a comma-separated list of output fields.
The available fields and their meaning are:
+@QUERY_FIELDS_JOB@
+If the value of the option starts with the character ``+``, the new
+fields will be added to the default list. This allows one to quickly
+see the default list plus a few other fields, instead of retyping
+the entire list of fields.
-id
- the job id
-
-status
- the status of the job
-
-priority
- current priority of the job
-
-received_ts
- the timestamp the job was received
-
-start_ts
- the timestamp when the job was started
-
-end_ts
- the timestamp when the job was ended
-
-summary
- a summary of the opcodes that define the job
-
-ops
- the list of opcodes defining the job
-
-opresult
- the list of opcode results
+To include archived jobs in the list the ``--archived`` option can be
+used.
-opstatus
- the list of opcode statuses
+The following options can be used to show only specific jobs:
-oplog
- the list of opcode logs
+``--pending``
+ Show only jobs pending execution.
+``--running``
+ Show jobs currently running only.
+``--error``
+ Show failed jobs only.
+``--finished``
+ Show finished jobs only.
-opstart
- the list of opcode start times (before acquiring locks)
+If exactly one argument is given and it appears to be a query filter
+(see **ganeti(7)**), the query result is filtered accordingly. For
+ambiguous cases (e.g. a single field name as a filter) the ``--filter``
+(``-F``) option forces the argument to be treated as a filter.
-opexec
- the list of opcode execution start times (after acquiring any
- necessary locks)
-opend
- the list of opcode end times
+LIST-FIELDS
+~~~~~~~~~~~
-oppriority
- the priority of each opcode
+**list-fields** [field...]
+Lists available fields for jobs.
-If the value of the option starts with the character ``+``, the new
-fields will be added to the default list. This allows to quickly
-see the default list plus a few other fields, instead of retyping
-the entire list of fields.
WATCH
~~~~~