- NAME
- 
- gcloud beta network-security mirroring-deployments create - create a Mirroring Deployment
 
- SYNOPSIS
- 
- 
gcloud beta network-security mirroring-deployments create(MIRRORING_DEPLOYMENT:--location=LOCATION) (--forwarding-rule=FORWARDING_RULE:--forwarding-rule-location=FORWARDING_RULE_LOCATION) (--mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP:--mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,…]] [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG …]
 
- 
- DESCRIPTION
- 
(BETA)Create a mirroring deployment. Successful creation of a deployment results in a deployment in ACTIVE state. Check the progress of deployment creation by usinggcloud network-security mirroring-deployments list.For more examples, refer to the EXAMPLES section below. 
- EXAMPLES
- 
To create a mirroring deployment called my-deployment, in project IDmy-projectand zoneus-central1-a, run:gcloud beta network-security mirroring-deployments create my-deployment --project=my-project --location=us-central1-a --deployment-group-location=global --forwarding-rule=my-forwarding-rule --forwarding-rule-location=us-central1 --mirroring-deployment-group=my-deployment-groupOR gcloud beta network-security mirroring-deployments create my-deployment --project=my-project --location=us-central1-a --forwarding-rule=projects/my-project/regions/us-central1/forwardingRules/my-forwarding-rule --mirroring-deployment-group=projects/my-project/locations/global/mirroringDeploymentGroups/my-deployment-groupOR gcloud beta network-security mirroring-deployments create projects/my-project/locations/us-central1/mirroringDeployments/my-deployment --forwarding-rule=projects/my-project/regions/us-central1/forwardingRules/my-forwarding-rule --mirroring-deployment-group=projects/my-project/locations/global/mirroringDeploymentGroups/my-deployment-groupOR gcloud beta network-security mirroring-deployments create projects/my-project/locations/us-central1/mirroringDeployments/my-deployment --forwarding-rule=projects/my-project/regions/us-central1/forwardingRules/my-forwarding-rule --mirroring-deployment-group=projects/my-project/locations/global/mirroringDeploymentGroups/my-deployment-group --description="my-description"
- POSITIONAL ARGUMENTS
- 
- 
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 projectattribute:- 
provide the argument MIRRORING_DEPLOYMENTon the command line with a fully specified name;
- 
provide the argument --projecton the command line;
- 
set the property core/project.
 This must be specified. - MIRRORING_DEPLOYMENT
- 
ID of the mirroring deployment or fully qualified identifier for the mirroring
deployment.
To set the deployment-idattribute:- 
provide the argument MIRRORING_DEPLOYMENTon the command line.
 This positional argument must be specified if any of the other arguments in this group are specified. 
- 
provide the argument 
- --location=- LOCATION
- 
Location of the mirroring deployment.
To set the locationattribute:- 
provide the argument MIRRORING_DEPLOYMENTon the command line with a fully specified name;
- 
provide the argument --locationon the command line.
 
- 
provide the argument 
 
- 
provide the argument 
 
- 
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.
- REQUIRED FLAGS
- 
- 
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 projectattribute:- 
provide the argument --forwarding-ruleon the command line with a fully specified name;
- 
provide the argument --projecton the command line;
- 
set the property core/project.
 This must be specified. - --forwarding-rule=- FORWARDING_RULE
- 
ID of the forwardingRule or fully qualified identifier for the forwardingRule.
To set the forwarding-rule-idattribute:- 
provide the argument --forwarding-ruleon the command line.
 This flag argument must be specified if any of the other arguments in this group are specified. 
- 
provide the argument 
- --forwarding-rule-location=- FORWARDING_RULE_LOCATION
- 
The Cloud region for the forwardingRule.
To set the forwarding-rule-locationattribute:- 
provide the argument --forwarding-ruleon the command line with a fully specified name;
- 
provide the argument --forwarding-rule-locationon the command line.
 
- 
provide the argument 
 
- 
provide the argument 
- 
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 projectattribute:- 
provide the argument --mirroring-deployment-groupon the command line with a fully specified name;
- 
provide the argument --projecton the command line;
- 
set the property core/project.
 This must be specified. - --mirroring-deployment-group=- MIRRORING_DEPLOYMENT_GROUP
- 
ID of the mirroring deployment group or fully qualified identifier for the
mirroring deployment group.
To set the idattribute:- 
provide the argument --mirroring-deployment-groupon the command line.
 This flag argument must be specified if any of the other arguments in this group are specified. 
- 
provide the argument 
- --mirroring-deployment-group-location=- MIRRORING_DEPLOYMENT_GROUP_LOCATION
- 
Location of the mirroring deployment group.
To set the locationattribute:- 
provide the argument --mirroring-deployment-groupon the command line with a fully specified name;
- 
provide the argument --mirroring-deployment-group-locationon the command line;
- 
provide the argument
networksecurity.projects.locations.mirroringDeploymentson the command line with a fully specified name.
 
- 
provide the argument 
 
- 
provide the argument 
 
- 
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.
- OPTIONAL FLAGS
- 
- --async
- 
Return immediately, without waiting for the operation in progress to complete.
The default is True. Enabled by default, use--no-asyncto disable.
- --description=- DESCRIPTION
- Description of the mirroring deployment
- --labels=[- KEY=- VALUE,…]
- 
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.
- --max-wait=- MAX_WAIT; 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.
 
- 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 $ gcloud helpfor details.
- NOTES
- 
This command is currently in beta and might change without notice. These
variants are also available:
gcloud network-security mirroring-deployments creategcloud alpha network-security mirroring-deployments create
      gcloud beta network-security mirroring-deployments create
  
  
  Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-19 UTC.