gcloud-help/gcloud/network-security/firewall-endpoints/update

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