gcloud alpha compute packet-mirrorings update

NAME
gcloud alpha compute packet-mirrorings update - update a Google Compute Engine packet mirroring
SYNOPSIS
gcloud alpha compute packet-mirrorings update NAME [--async] [--collector-ilb=COLLECTOR_ILB] [--description=DESCRIPTION] [--enable] [--priority=PRIORITY] [--region=REGION] [--add-filter-cidr-ranges=[CIDR_RANGE,…]     | --clear-filter-cidr-ranges     | --remove-filter-cidr-ranges=[CIDR_RANGE,…]     | --set-filter-cidr-ranges=[CIDR_RANGE,…]] [--add-filter-protocols=[PROTOCOL,…]     | --clear-filter-protocols     | --remove-filter-protocols=[PROTOCOL,…]     | --set-filter-protocols=[PROTOCOL,…]] [--add-mirrored-instances=[INSTANCE,…]     | --clear-mirrored-instances     | --remove-mirrored-instances=[INSTANCE,…]     | --set-mirrored-instances=[INSTANCE,…]] [--add-mirrored-subnets=[SUBNET,…]     | --clear-mirrored-subnets     | --remove-mirrored-subnets=[SUBNET,…]     | --set-mirrored-subnets=[SUBNET,…]] [--add-mirrored-tags=[TAG,…]     | --clear-mirrored-tags     | --remove-mirrored-tags=[TAG,…]     | --set-mirrored-tags=[TAG,…]] [GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Update a Google Compute Engine packet mirroring.
POSITIONAL ARGUMENTS
NAME
Name of the packet mirroring to update.
FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--collector-ilb=COLLECTOR_ILB
Forwarding rule configured as collector. This must be a regional forwarding rule (in the same region) with load balancing scheme INTERNAL and isMirroringCollector set to true.

You can provide this as the full URL to the forwarding rule, partial URL, or name. For example, the following are valid values:

--description=DESCRIPTION
Optional, textual description for the packet mirroring.
--enable
Enable or disable the packet-mirroring.
--priority=PRIORITY
Priority of applying this packet mirroring. Priority is used to break ties in cases where there is more than one matching policy. In the case of two policies that apply for a given Instance, the one with the lowest-numbered priority value wins. Mirroring all instances in a region for the network may produce a lot of mirrored traffic. If you want to "zoom in" on a subset of that traffic you can create another packet mirroring with a more restricted set of mirrored instances (using the --mirrored- flags) or a more restrictive CIDR filter and send that traffic to a dedicated collector. Because we cannot mirror traffic to multiple sets of collector, you should set the priority for the more specific packet mirroring configuration to a lower value to ensure the packets are sent to the desired collector. Default value is 1000. Valid range is 0 through 65535. If multiple policies end up having the same priority, then one of the policies is picked non-deterministically.
--region=REGION
Region of the packet mirroring to update. Overrides the default compute/region property value for this command invocation.
Update the filter CIDR ranges of this packet mirroring. At most one of these may be specified:
--add-filter-cidr-ranges=[CIDR_RANGE,…]
List of filter CIDR ranges to add to the packet mirroring.
--clear-filter-cidr-ranges
If specified, clear the existing filter CIDR ranges from the packet mirroring.
--remove-filter-cidr-ranges=[CIDR_RANGE,…]
List of filter CIDR ranges to remove from the packet mirroring.
--set-filter-cidr-ranges=[CIDR_RANGE,…]
List of filter CIDR ranges to be mirrored on the packet mirroring.
Update the filter protocols of this packet mirroring. At most one of these may be specified:
--add-filter-protocols=[PROTOCOL,…]
List of filter IP protocols to add to the packet mirroring. PROTOCOL must be one of: tcp, udp, icmp.
--clear-filter-protocols
If specified, clear the existing filter IP protocols from the packet mirroring.
--remove-filter-protocols=[PROTOCOL,…]
List of filter IP protocols to remove from the packet mirroring. PROTOCOL must be one of: tcp, udp, icmp.
--set-filter-protocols=[PROTOCOL,…]
List of filter IP protocols to be mirrored on the packet mirroring. PROTOCOL must be one of: tcp, udp, icmp.
Update the mirrored instances of this packet mirroring. At most one of these may be specified:
--add-mirrored-instances=[INSTANCE,…]
List of instances to add to the packet mirroring.
--clear-mirrored-instances
If specified, clear the existing instances from the packet mirroring.
--remove-mirrored-instances=[INSTANCE,…]
List of instances to remove from the packet mirroring.
--set-mirrored-instances=[INSTANCE,…]
List of instances to be mirrored on the packet mirroring.
Update the mirrored subnets of this packet mirroring. At most one of these may be specified:
--add-mirrored-subnets=[SUBNET,…]
List of subnets to add to the packet mirroring.
--clear-mirrored-subnets
If specified, clear the existing subnets from the packet mirroring.
--remove-mirrored-subnets=[SUBNET,…]
List of subnets to remove from the packet mirroring.
--set-mirrored-subnets=[SUBNET,…]
List of subnets to be mirrored on the packet mirroring.
Update the mirrored tags of this packet mirroring. To read more about configuring network tags, read this guide: https://cloud.google.com/vpc/docs/add-remove-network-tags

The virtual machines with the provided tags must live in zones contained in the same region as this packet mirroring. At most one of these may be specified:

--add-mirrored-tags=[TAG,…]
List of tags to add to the packet mirroring.
--clear-mirrored-tags
If specified, clear the existing tags from the packet mirroring.
--remove-mirrored-tags=[TAG,…]
List of tags to remove from the packet mirroring.
--set-mirrored-tags=[TAG,…]
List of tags to be mirrored on the packet mirroring.
GCLOUD WIDE FLAGS
These flags are available to all commands: --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.

EXAMPLES
Stop mirroring by tags, add subnet-1 as a mirrored subnet.
  $ gcloud alpha compute packet-mirrorings update my-pm
      --region us-central1 --clear-mirrored-tags
      --add-mirrored-subnets subnet-1

Change the load-balancer to send mirrored traffic to.

  $ gcloud alpha compute packet-mirrorings update my-pm
      --region us-central1 --collector-ilb new-forwarding-rule

Disable a Packet Mirroring policy.

  $ gcloud alpha compute packet-mirrorings update my-pm
      --region us-central1 --no-enable

Re-enable a disabled Packet Mirroring policy.

  $ gcloud alpha compute packet-mirrorings update my-pm
      --region us-central1 --enable
NOTES
This command is currently in ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you may be trying to access an API with an invitation-only early access whitelist. This variant is also available:
  $ gcloud beta compute packet-mirrorings update