.TH "GCLOUD_WORKFLOWS_EXECUTE" 1



.SH "NAME"
.HP
gcloud workflows execute \- execute a workflow



.SH "SYNOPSIS"
.HP
\f5gcloud workflows execute\fR (\fIWORKFLOW\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-call\-log\-level\fR=\fICALL_LOG_LEVEL\fR;\ default="none"] [\fB\-\-data\fR=\fIDATA\fR] [\fB\-\-disable\-concurrency\-quota\-overflow\-buffering\fR] [\fB\-\-execution\-history\-level\fR=\fIEXECUTION_HISTORY_LEVEL\fR;\ default="none"] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Execute a workflow.



.SH "EXAMPLES"

To execute a workflow named 'my\-workflow' with the data that will be passed to
the workflow, run:

.RS 2m
$ gcloud workflows execute my\-workflow \-\-data=my\-data
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Workflow resource \- Name of the workflow to execute. The arguments in this
group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5workflow\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIWORKFLOW\fR

ID of the workflow or fully qualified identifier for the workflow.

To set the \f5workflow\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5workflow\fR on the command line.
.RE
.sp

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

The Cloud location for the workflow. Alternatively, set the property
[workflows/location].


To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5workflow\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
set the property \f5workflows/location\fR.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-call\-log\-level\fR=\fICALL_LOG_LEVEL\fR; default="none"

Level of call logging to apply during execution. \fICALL_LOG_LEVEL\fR must be
one of:

.RS 2m
.TP 2m
\fBlog\-all\-calls\fR
Log all calls to subworkflows or library functions and their results.

.TP 2m
\fBlog\-errors\-only\fR
Log when a call is stopped due to an exception.

.TP 2m
\fBlog\-none\fR
Perform no call logging.

.TP 2m
\fBnone\fR
No call logging level specified.

.RE
.sp


.TP 2m
\fB\-\-data\fR=\fIDATA\fR

JSON string with data that will be passed to the workflow as an argument.

.TP 2m
\fB\-\-disable\-concurrency\-quota\-overflow\-buffering\fR

If set, the execution will not be backlogged when the concurrency quota is
exhausted. Backlogged executions start when the concurrency quota becomes
available.

.TP 2m
\fB\-\-execution\-history\-level\fR=\fIEXECUTION_HISTORY_LEVEL\fR; default="none"

Level of execution history to apply during execution.
\fIEXECUTION_HISTORY_LEVEL\fR must be one of:

.RS 2m
.TP 2m
\fBexecution\-history\-basic\fR
Enable basic execution history.

.TP 2m
\fBexecution\-history\-detailed\fR
Enable detailed execution history, including expected iterations and in\-scope
variable values.

.TP 2m
\fBnone\fR
No execution history level specified.

.RE
.sp


.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens,
underscores, lowercase characters, and numbers. Values must contain only
hyphens, underscores, lowercase characters, and numbers.


.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 "API REFERENCE"

This command uses the \fBworkflowexecutions/v1\fR API. The full documentation
for this API can be found at: https://cloud.google.com/workflows



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud beta workflows execute
.RE