.TH "GCLOUD_TRANSFER_JOBS_LIST" 1



.SH "NAME"
.HP
gcloud transfer jobs list \- list Transfer Service transfer jobs



.SH "SYNOPSIS"
.HP
\f5gcloud transfer jobs list\fR [\fB\-\-limit\fR=\fILIMIT\fR] [\fB\-\-page\-size\fR=\fIPAGE_SIZE\fR;\ default=256] [\fB\-\-job\-names\fR=[\fIJOB_NAMES\fR,...]] [\fB\-\-job\-statuses\fR=[\fIJOB_STATUSES\fR,...]] [\fB\-\-expand\-table\fR] [\fB\-\-job\-type\fR=\fIJOB_TYPE\fR;\ default="transfer"] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

List Transfer Service transfer jobs in a given project to show their
configurations and latest operations.



.SH "EXAMPLES"

To list all jobs in your current project, run:

.RS 2m
$ gcloud transfer jobs list
.RE

To list all disabled jobs in your project, run:

.RS 2m
$ gcloud transfer jobs list \-\-job\-statuses=disabled
.RE

To list jobs 'foo' and 'bar', run:

.RS 2m
$ gcloud transfer jobs list \-\-job\-names=foo,bar
.RE

To list all information about all jobs formatted as JSON, run:

.RS 2m
$ gcloud transfer jobs list \-\-format=json
.RE

To list all information about jobs 'foo' and 'bar' formatted as YAML, run:

.RS 2m
$ gcloud transfer jobs list \-\-job\-names=foo,bar \-\-format=YAML
.RE



.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-limit\fR=\fILIMIT\fR

Return the first items from the API up to this limit.

.TP 2m
\fB\-\-page\-size\fR=\fIPAGE_SIZE\fR; default=256

Retrieve batches of this many items from the API.

.TP 2m
\fB\-\-job\-names\fR=[\fIJOB_NAMES\fR,...]

The names of the jobs you want to list. Separate multiple job names with commas
(e.g., \-\-job\-names=foo,bar). If not specified, all jobs will be listed.

.TP 2m
\fB\-\-job\-statuses\fR=[\fIJOB_STATUSES\fR,...]

List only jobs with the statuses you specify. Options include 'enabled',
\'disabled', 'deleted' (case insensitive). Separate multiple statuses with
commas (e.g., \-\-job\-statuses=enabled,deleted). If not specified, all jobs
will be listed.

.TP 2m
\fB\-\-expand\-table\fR

Include additional table columns (job name, source, destination, frequency,
lastest operation name, job status) in command output. Tip: increase the size of
your terminal before running the command.

.TP 2m
\fB\-\-job\-type\fR=\fIJOB_TYPE\fR; default="transfer"

The type of the job you want to list. \fIJOB_TYPE\fR must be one of:
\fBtransfer\fR, \fBreplication\fR.


.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud alpha transfer jobs list
.RE