gcloud_dataflow_jobs_list (1)
NAME
- gcloud dataflow jobs list - lists all jobs in a particular project, optionally filtered by region
SYNOPSIS
-
gcloud dataflow jobs list [--created-after=CREATED_AFTER] [--created-before=CREATED_BEFORE] [--region=REGION] [--status=STATUS] [--filter=EXPRESSION] [--limit=LIMIT; default=100] [--page-size=PAGE_SIZE; default=20] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Using the --region flag will only list jobs from the given regional endpoint.
FLAGS
-
- --created-after=CREATED_AFTER
-
Filter the jobs to those created after the given time. See $ gcloud topic
datetimes for information on time formats. For example, 2018-01-01 is
the first day of the year, and -P2W is 2 weeks ago.
- --created-before=CREATED_BEFORE
-
Filter the jobs to those created before the given time. See $ gcloud topic
datetimes for information on time formats.
- --region=REGION
-
If provided, only resources from the given region are queried.
- --status=STATUS
-
Filter the jobs to those with the selected status. STATUS must be one of:
-
- active
- Filters the jobs that are running ordered on the creation timestamp.
- all
- Returns running jobs first, ordered on creation timestamp, then, returns all terminated jobs ordered on the termination timestamp.
- terminated
- Filters the jobs that have a terminated state, ordered on the termination timestamp. Example terminated states: Done, Updated, Cancelled, etc.
-
LIST COMMAND FLAGS
-
- --filter=EXPRESSION
-
Apply a Boolean filter EXPRESSION to each resource item to be listed. If
the expression evaluates True, then that item is listed. For more details
and examples of filter expressions, run $ gcloud topic filters. This flag
interacts with other flags that are applied in this order: --flatten,
--sort-by, --filter, --limit.
- --limit=LIMIT; default=100
-
Maximum number of resources to list. The default is 100. This flag
interacts with other flags that are applied in this order: --flatten,
--sort-by, --filter, --limit.
- --page-size=PAGE_SIZE; default=20
-
Some services group resource list output into pages. This flag specifies the
maximum number of resources per page. The default is 20. Paging may be
applied before or after --filter and --limit depending on the
service.
- --sort-by=[FIELD,...]
-
Comma-separated list of resource field key names to sort by. The default order
is ascending. Prefix a field with ``~'' for descending order on that field. This
flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
- --uri
-
Print a list of resource URIs instead of the default output.
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
EXAMPLES
Filter jobs with the given name:
- $ gcloud dataflow jobs list --filter="name=my-wordcount"
List jobs with from a given region:
- $ gcloud dataflow jobs list --region="europe-west1"
List jobs created this year:
- $ gcloud dataflow jobs list --created-after=2018-01-01
List jobs created more than a week ago:
- $ gcloud dataflow jobs list --created-before=-P1W
NOTES
This variant is also available:
- $ gcloud beta dataflow jobs list