NAME
    gcloud alpha network-security dns-threat-detectors update - update a
        DnsThreatDetector resource

SYNOPSIS
    gcloud alpha network-security dns-threat-detectors update
        (DNS_THREAT_DETECTOR : --location=LOCATION) [--provider=PROVIDER]
        [--excluded-networks=[EXCLUDED_NETWORKS,...]
          | --add-excluded-networks=[ADD_EXCLUDED_NETWORKS,...]
          --clear-excluded-networks
          | --remove-excluded-networks=[REMOVE_EXCLUDED_NETWORKS,...]]
        [--labels=[LABELS,...]
          | --update-labels=[UPDATE_LABELS,...] --clear-labels
          | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Update a DnsThreatDetector resource.

EXAMPLES
    To update DnsThreatDetector resource my-dns-threat-detector with an
    additional excluded network, run:

        $ gcloud alpha network-security dns-threat-detectors update \
            --location=global \
            --add-excluded-networks=projects/.../global/networks/\
        my-excluded-network my-dns-threat-detector

POSITIONAL ARGUMENTS
     DnsThreatDetector resource - Identifier. Name of the DnsThreatDetector
     resource. 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 dns_threat_detector 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.

       DNS_THREAT_DETECTOR
          ID of the dnsThreatDetector or fully qualified identifier for the
          dnsThreatDetector.

          To set the dns_threat_detector attribute:
          ▸ provide the argument dns_threat_detector on the command line.

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

       --location=LOCATION
          The location id of the dnsThreatDetector resource.

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

FLAGS
     --provider=PROVIDER
        The provider used for DNS threat analysis. PROVIDER must be (only one
        value is supported):

         infoblox
            The Infoblox DNS threat detector provider.

     Update excluded_networks.

     At most one of these can be specified:

       Network resource - Set excluded_networks to new value.

       A list of network resource names which aren't monitored by this
       DnsThreatDetector.

       Example: projects/PROJECT_ID/global/networks/NETWORK_NAME. This
       represents a Cloud 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 --excluded-networks on the command line with a
          fully specified name;
        ▸ provide the argument --project on the command line;
        ▸ set the property core/project.

       --excluded-networks=[EXCLUDED_NETWORKS,...]
          IDs of the networks or fully qualified identifiers for the networks.

          To set the network attribute:
          ▸ provide the argument --excluded-networks on the command line.

       Network resource - Add new value to excluded_networks list.

       A list of network resource names which aren't monitored by this
       DnsThreatDetector.

       Example: projects/PROJECT_ID/global/networks/NETWORK_NAME. This
       represents a Cloud 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 --add-excluded-networks on the command line
          with a fully specified name;
        ▸ provide the argument --project on the command line;
        ▸ set the property core/project.

       --add-excluded-networks=[ADD_EXCLUDED_NETWORKS,...]
          IDs of the networks or fully qualified identifiers for the networks.

          To set the network attribute:
          ▸ provide the argument --add-excluded-networks on the command line.

       At most one of these can be specified:

         --clear-excluded-networks
            Clear excluded_networks value and set to empty list.

         Or at least one of these can be specified:

           Network resource - Remove value from excluded_networks list.

           A list of network resource names which aren't monitored by this
           DnsThreatDetector.

           Example: projects/PROJECT_ID/global/networks/NETWORK_NAME. This
           represents a Cloud 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 --remove-excluded-networks on the command
              line with a fully specified name;
            ◇ provide the argument --project on the command line;
            ◇ set the property core/project.

           --remove-excluded-networks=[REMOVE_EXCLUDED_NETWORKS,...]
              IDs of the networks or fully qualified identifiers for the
              networks.

              To set the network attribute:
              ◇ provide the argument --remove-excluded-networks on the
                command line.

     Update labels.

     At most one of these can be specified:

       --labels=[LABELS,...]
          Set labels to new value. Any labels associated with the
          DnsThreatDetector, listed as key value pairs.

           KEY
              Keys must start with a lowercase character and contain only
              hyphens (-), underscores (_), lowercase characters, and numbers.

           VALUE
              Values must contain only hyphens (-), underscores (_), lowercase
              characters, and numbers.

          Shorthand Example:

              --labels=string=string

          JSON Example:

              --labels='{"string": "string"}'

          File Example:

              --labels=path_to_file.(yaml|json)

       Or at least one of these can be specified:

         --update-labels=[UPDATE_LABELS,...]
            Update labels value or add key value pair. Any labels associated
            with the DnsThreatDetector, listed as key value pairs.

             KEY
                Keys must start with a lowercase character and contain only
                hyphens (-), underscores (_), lowercase characters, and
                numbers.

             VALUE
                Values must contain only hyphens (-), underscores (_),
                lowercase characters, and numbers.

            Shorthand Example:

                --update-labels=string=string

            JSON Example:

                --update-labels='{"string": "string"}'

            File Example:

                --update-labels=path_to_file.(yaml|json)

         At most one of these can be specified:

           --clear-labels
              Clear labels value and set to empty map.

           --remove-labels=REMOVE_LABELS
              Remove existing value from map labels. Sets remove_labels value.

              Shorthand Example:

                  --remove-labels=string,string

              JSON Example:

                  --remove-labels=["string"]

              File Example:

                  --remove-labels=path_to_file.(yaml|json)

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.

API REFERENCE
    This command uses the networksecurity/v1alpha1 API. The full documentation
    for this API can be found at: https://cloud.google.com/networking

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. These variants are also available:

        $ gcloud network-security dns-threat-detectors update

        $ gcloud beta network-security dns-threat-detectors update

