File: //snap/google-cloud-cli/394/help/man/man1/gcloud_network-security_mirroring-deployments_create.1
.TH "GCLOUD_NETWORK\-SECURITY_MIRRORING\-DEPLOYMENTS_CREATE" 1
.SH "NAME"
.HP
gcloud network\-security mirroring\-deployments create \- create a Mirroring Deployment
.SH "SYNOPSIS"
.HP
\f5gcloud network\-security mirroring\-deployments create\fR (\fIMIRRORING_DEPLOYMENT\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) (\fB\-\-forwarding\-rule\fR=\fIFORWARDING_RULE\fR\ :\ \fB\-\-forwarding\-rule\-location\fR=\fIFORWARDING_RULE_LOCATION\fR) (\fB\-\-mirroring\-deployment\-group\fR=\fIMIRRORING_DEPLOYMENT_GROUP\fR\ :\ \fB\-\-mirroring\-deployment\-group\-location\fR=\fIMIRRORING_DEPLOYMENT_GROUP_LOCATION\fR) [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-max\-wait\fR=\fIMAX_WAIT\fR;\ default="20m"] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
Create a mirroring deployment. Successful creation of a deployment results in a
deployment in ACTIVE state. Check the progress of deployment creation by using
\f5gcloud network\-security mirroring\-deployments list\fR.
For more examples, refer to the EXAMPLES section below.
.SH "EXAMPLES"
To create a mirroring deployment called \f5my\-deployment\fR, in project ID
\f5my\-project\fR and zone \f5us\-central1\-a\fR, run:.RS 2m
$ gcloud network\-security mirroring\-deployments create \e
my\-deployment \-\-project=my\-project \-\-location=us\-central1\-a \e
\-\-deployment\-group\-location=global \e
\-\-forwarding\-rule=my\-forwarding\-rule \e
\-\-forwarding\-rule\-location=us\-central1 \e
\-\-mirroring\-deployment\-group=my\-deployment\-group
.RE
OR
.RS 2m
$ gcloud network\-security mirroring\-deployments create \e
my\-deployment \-\-project=my\-project \-\-location=us\-central1\-a \e
\-\-forwarding\-rule=projects/my\-project/regions/us\-central1/\e
forwardingRules/my\-forwarding\-rule \e
\-\-mirroring\-deployment\-group=projects/my\-project/locations/\e
global/mirroringDeploymentGroups/my\-deployment\-group
.RE
OR
.RS 2m
$ gcloud network\-security mirroring\-deployments create \e
projects/my\-project/locations/us\-central1/mirroringDeployments/\e
my\-deployment \e
\-\-forwarding\-rule=projects/my\-project/regions/us\-central1/\e
forwardingRules/my\-forwarding\-rule \e
\-\-mirroring\-deployment\-group=projects/my\-project/locations/\e
global/mirroringDeploymentGroups/my\-deployment\-group
.RE
OR
.RS 2m
$ gcloud network\-security mirroring\-deployments create \e
projects/my\-project/locations/us\-central1/mirroringDeployments/\e
my\-deployment \e
\-\-forwarding\-rule=projects/my\-project/regions/us\-central1/\e
forwardingRules/my\-forwarding\-rule \e
\-\-mirroring\-deployment\-group=projects/my\-project/locations/\e
global/mirroringDeploymentGroups/my\-deployment\-group \e
\-\-description="my\-description"
.RE
.SH "POSITIONAL ARGUMENTS"
.RS 2m
.TP 2m
Mirroring deployment resource \- Mirroring Deployment. 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 \f5MIRRORING_DEPLOYMENT\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
\fIMIRRORING_DEPLOYMENT\fR
ID of the mirroring deployment or fully qualified identifier for the mirroring
deployment.
To set the \f5deployment\-id\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5MIRRORING_DEPLOYMENT\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
Location of the mirroring deployment.
To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5MIRRORING_DEPLOYMENT\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp
.RE
.RE
.sp
.SH "REQUIRED FLAGS"
.RS 2m
.TP 2m
ForwardingRule resource \- Mirroring Deployment Forwarding Rule. 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 \f5\-\-forwarding\-rule\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
\fB\-\-forwarding\-rule\fR=\fIFORWARDING_RULE\fR
ID of the forwardingRule or fully qualified identifier for the forwardingRule.
To set the \f5forwarding\-rule\-id\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-forwarding\-rule\fR on the command line.
.RE
.sp
This flag argument must be specified if any of the other arguments in this group
are specified.
.TP 2m
\fB\-\-forwarding\-rule\-location\fR=\fIFORWARDING_RULE_LOCATION\fR
The Cloud region for the forwardingRule.
To set the \f5forwarding\-rule\-location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-forwarding\-rule\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-forwarding\-rule\-location\fR on the command line.
.RE
.sp
.RE
.sp
.TP 2m
Mirroring deployment group resource \- Mirroring Deployment Group. 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 \f5\-\-mirroring\-deployment\-group\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
\fB\-\-mirroring\-deployment\-group\fR=\fIMIRRORING_DEPLOYMENT_GROUP\fR
ID of the mirroring deployment group or fully qualified identifier for the
mirroring deployment group.
To set the \f5id\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-mirroring\-deployment\-group\fR on the command line.
.RE
.sp
This flag argument must be specified if any of the other arguments in this group
are specified.
.TP 2m
\fB\-\-mirroring\-deployment\-group\-location\fR=\fIMIRRORING_DEPLOYMENT_GROUP_LOCATION\fR
Location of the mirroring deployment group.
To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-mirroring\-deployment\-group\fR on the command line
with a fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-mirroring\-deployment\-group\-location\fR on the
command line;
.IP "\(bu" 2m
provide the argument
\f5networksecurity.projects.locations.mirroringDeployments\fR on the command
line with a fully specified name.
.RE
.sp
.RE
.RE
.sp
.SH "OPTIONAL FLAGS"
.RS 2m
.TP 2m
\fB\-\-async\fR
Return immediately, without waiting for the operation in progress to complete.
The default is \fBTrue\fR. Enabled by default, use \fB\-\-no\-async\fR to
disable.
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR
Description of the mirroring deployment
.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 (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.
.TP 2m
\fB\-\-max\-wait\fR=\fIMAX_WAIT\fR; default="20m"
Time to synchronously wait for the operation to complete, after which the
operation continues asynchronously. Ignored if \-\-no\-async isn't specified.
See $ gcloud topic datetimes for information on time formats.
.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"
These variants are also available:
.RS 2m
$ gcloud alpha network\-security mirroring\-deployments create
.RE
.RS 2m
$ gcloud beta network\-security mirroring\-deployments create
.RE