gcloud-help/gcloud/alpha/network-security/mirroring-deployments/create

NAME
    gcloud alpha network-security mirroring-deployments create - create a
        Mirroring Deployment

SYNOPSIS
    gcloud alpha 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] [--labels=[KEY=VALUE,...]]
        [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create a mirroring deployment. Successful creation of a deployment
    results in a deployment in ACTIVE state. Check the progress of deployment
    creation by using gcloud 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 ID
    my-project and zone us-central1-a, run:        $ gcloud alpha 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-group

    OR

        $ gcloud alpha 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-group

    OR

        $ gcloud alpha 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

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 project attribute:
      ◆ provide the argument MIRRORING_DEPLOYMENT on the command line with a
        fully specified name;
      ◆ provide the argument --project on 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-id attribute:
          ▸ provide the argument MIRRORING_DEPLOYMENT on the command line.

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

       --location=LOCATION
          Location of the mirroring deployment.

          To set the location attribute:
          ▸ provide the argument MIRRORING_DEPLOYMENT on the command line
            with a fully specified name;
          ▸ provide the argument --location on the command line.

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 project attribute:
      ◆ provide the argument --forwarding-rule on the command line with a
        fully specified name;
      ◆ provide the argument --project on 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-id attribute:
          ▸ provide the argument --forwarding-rule on the command line.

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

       --forwarding-rule-location=FORWARDING_RULE_LOCATION
          The Cloud region for the forwardingRule.

          To set the forwarding-rule-location attribute:
          ▸ provide the argument --forwarding-rule on the command line with a
            fully specified name;
          ▸ provide the argument --forwarding-rule-location on the command
            line.

     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 project attribute:
      ◆ provide the argument --mirroring-deployment-group on the command line
        with a fully specified name;
      ◆ provide the argument --project on 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 id attribute:
          ▸ provide the argument --mirroring-deployment-group on the command
            line.

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

       --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION
          Location of the mirroring deployment group.

          To set the location attribute:
          ▸ provide the argument --mirroring-deployment-group on the command
            line with a fully specified name;
          ▸ provide the argument --mirroring-deployment-group-location on the
            command line;
          ▸ provide the argument --location on the command line;
          ▸ provide the argument
            networksecurity.projects.locations.mirroringDeployments on the
            command line with a fully specified name.

OPTIONAL FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete. The default is True. Enabled by default, use --no-async to
        disable.

     --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 help for details.

NOTES
    This command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. This variant is also available:

        $ gcloud beta network-security mirroring-deployments create