HEX
Server: Apache/2.4.65 (Ubuntu)
System: Linux ielts-store-v2 6.8.0-1036-gcp #38~22.04.1-Ubuntu SMP Thu Aug 14 01:19:18 UTC 2025 x86_64
User: root (0)
PHP: 7.2.34-54+ubuntu20.04.1+deb.sury.org+1
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,
Upload Files
File: //snap/google-cloud-cli/396/help/man/man1/gcloud_dataflow_yaml_run.1
.TH "GCLOUD_DATAFLOW_YAML_RUN" 1



.SH "NAME"
.HP
gcloud dataflow yaml run \- runs a job from the specified path



.SH "SYNOPSIS"
.HP
\f5gcloud dataflow yaml run\fR \fIJOB_NAME\fR (\fB\-\-yaml\-pipeline\fR=\fIYAML_PIPELINE\fR\ |\ \fB\-\-yaml\-pipeline\-file\fR=\fIYAML_PIPELINE_FILE\fR) [\fB\-\-jinja\-variables\fR=\fIJSON_OBJECT\fR] [\fB\-\-network\fR=\fINETWORK\fR] [\fB\-\-pipeline\-options\fR=[\fIOPTIONS\fR=\fIVALUE\fR;\fIOPTION\fR=\fIVALUE\fR,...]] [\fB\-\-region\fR=\fIREGION_ID\fR] [\fB\-\-subnetwork\fR=\fISUBNETWORK\fR] [\fB\-\-template\-file\-gcs\-location\fR=\fITEMPLATE_FILE_GCS_LOCATION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Runs a job from the specified YAML description or Cloud Storage path.



.SH "EXAMPLES"

To run a job from YAML, run:

.RS 2m
$ gcloud dataflow yaml run my\-job \e
    \-\-yaml\-pipeline\-file=gs://yaml\-path \-\-region=europe\-west1
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIJOB_NAME\fR

Unique name to assign to the job.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-yaml\-pipeline\fR=\fIYAML_PIPELINE\fR

Inline definition of the YAML pipeline to run.

.TP 2m
\fB\-\-yaml\-pipeline\-file\fR=\fIYAML_PIPELINE_FILE\fR

Path of a file defining the YAML pipeline to run. (Must be a local file or a URL
beginning with 'gs://'.)


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-jinja\-variables\fR=\fIJSON_OBJECT\fR

Jinja2 variables to be used in reifying the yaml.

.TP 2m
\fB\-\-network\fR=\fINETWORK\fR

Compute Engine network for launching worker instances to run the pipeline. If
not set, the default network is used.

.TP 2m
\fB\-\-pipeline\-options\fR=[\fIOPTIONS\fR=\fIVALUE\fR;\fIOPTION\fR=\fIVALUE\fR,...]

Pipeline options to pass to the job.

.TP 2m
\fB\-\-region\fR=\fIREGION_ID\fR

Region ID of the job's regional endpoint. Defaults to 'us\-central1'.

.TP 2m
\fB\-\-subnetwork\fR=\fISUBNETWORK\fR

Compute Engine subnetwork for launching worker instances to run the pipeline. If
not set, the default subnetwork is used.

.TP 2m
\fB\-\-template\-file\-gcs\-location\fR=\fITEMPLATE_FILE_GCS_LOCATION\fR

Google Cloud Storage location of the YAML template to run. (Must be a URL
beginning with 'gs://'.)


.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 beta dataflow yaml run
.RE