gcloud: Fri Mar 22 09:56:14 UTC 2024

gcloud/network-security/firewall-endpoints/update

@@ -0,0 +1,131 @@
+NAME
+    gcloud network-security firewall-endpoints update - update a Firewall Plus
+        endpoint
+
+SYNOPSIS
+    gcloud network-security firewall-endpoints update
+        (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async]
+        [--description=DESCRIPTION] [--max-wait=MAX_WAIT; default="60m"]
+        [--update-billing-project=BILLING_PROJECT]
+        [--update-labels=[KEY=VALUE,...]]
+        [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Update a firewall endpoint. Check the progress of endpoint update by using
+    gcloud network-security firewall-endpoints describe.
+
+    For more examples, refer to the EXAMPLES section below.
+
+EXAMPLES
+    To update labels k1 and k2, run:
+
+        $ gcloud network-security firewall-endpoints update my-endpoint \
+            --zone=us-central1-a --organization=1234 \
+            --update-labels=k1=v1,k2=v2
+
+    To remove labels k3 and k4, run:
+
+        $ gcloud network-security firewall-endpoints update my-endpoint \
+            --zone=us-central1-a --organization=1234 --remove-labels=k3,k4
+
+    To clear all labels from the firewall endpoint, run:
+
+        $ gcloud network-security firewall-endpoints update my-endpoint \
+            --zone=us-central1-a --organization=1234 --clear-labels
+
+POSITIONAL ARGUMENTS
+     Firewall endpoint resource - Firewall Plus. The arguments in this group
+     can be used to specify the attributes of this resource.
+
+     This must be specified.
+
+       FIREWALL_ENDPOINT
+          ID of the firewall endpoint or fully qualified identifier for the
+          firewall endpoint.
+
+          To set the endpoint-name attribute:
+          ▸ provide the argument FIREWALL_ENDPOINT on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --organization=ORGANIZATION
+          Organization ID of the firewall endpoint.
+
+          To set the organization attribute:
+          ▸ provide the argument FIREWALL_ENDPOINT on the command line with a
+            fully specified name;
+          ▸ provide the argument --organization on the command line.
+
+       --zone=ZONE
+          Zone of the firewall endpoint.
+
+          To set the zone attribute:
+          ▸ provide the argument FIREWALL_ENDPOINT on the command line with a
+            fully specified name;
+          ▸ provide the argument --zone on the command line.
+
+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.
+
+     --description=DESCRIPTION
+        Description of the endpoint
+
+     --max-wait=MAX_WAIT; default="60m"
+        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.
+
+     --update-billing-project=BILLING_PROJECT
+        The Google Cloud project ID to use for API enablement check, quota, and
+        endpoint uptime billing. Overrides the default billing/quota_project
+        property value for this command invocation.
+
+     --update-labels=[KEY=VALUE,...]
+        List of label KEY=VALUE pairs to update. If a label exists, its value
+        is modified. Otherwise, a new label is created.
+
+        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.
+
+     At most one of these can be specified:
+
+       --clear-labels
+          Remove all labels. If --update-labels is also specified then
+          --clear-labels is applied first.
+
+          For example, to remove all labels:
+
+              $ gcloud network-security firewall-endpoints update --clear-labels
+
+          To remove all existing labels and create two new labels, foo and baz:
+
+              $ gcloud network-security firewall-endpoints update --clear-labels \
+                --update-labels foo=bar,baz=qux
+
+       --remove-labels=[KEY,...]
+          List of label keys to remove. If a label does not exist it is
+          silently ignored. If --update-labels is also specified then
+          --update-labels is applied first.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha network-security firewall-endpoints update
+
+        $ gcloud beta network-security firewall-endpoints update
+