# REST Resource: projects.locations.dnsThreatDetectors

## Resource: DnsThreatDetector

A DNS threat detector sends DNS query logs to a *provider* that then analyzes the logs to identify threat events in the DNS queries. By default, all VPC networks in your projects are included. You can exclude specific networks by supplying `excludedNetworks`.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "excludedNetworks": [ string ], "provider": enum (`https://docs.cloud.google.com/dns/docs/reference/dns-armor/rest/v1beta1/projects.locations.dnsThreatDetectors#Provider`) } ``` |

| Fields ||
|---|---|
| `name` | `string` Immutable. Identifier. Name of the DnsThreatDetector resource. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Create time stamp. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Update time stamp. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `labels` | `map (key: string, value: string)` Optional. Any labels associated with the DnsThreatDetector, listed as key value pairs. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `excludedNetworks[]` | `string` Optional. A list of network resource names which aren't monitored by this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`. |
| `provider` | ``enum (`https://docs.cloud.google.com/dns/docs/reference/dns-armor/rest/v1beta1/projects.locations.dnsThreatDetectors#Provider`)`` Required. The provider used for DNS threat analysis. |

## Provider

Name of the provider used for DNS threat analysis.

| Enums ||
|---|---|
| `PROVIDER_UNSPECIFIED` | An unspecified provider. |
| `INFOBLOX` | The Infoblox DNS threat detector provider. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/dns/docs/reference/dns-armor/rest/v1beta1/projects.locations.dnsThreatDetectors/create` | Creates a new DnsThreatDetector in a given project and location. |
| ### `https://docs.cloud.google.com/dns/docs/reference/dns-armor/rest/v1beta1/projects.locations.dnsThreatDetectors/delete` | Deletes a single DnsThreatDetector. |
| ### `https://docs.cloud.google.com/dns/docs/reference/dns-armor/rest/v1beta1/projects.locations.dnsThreatDetectors/get` | Gets the details of a single DnsThreatDetector. |
| ### `https://docs.cloud.google.com/dns/docs/reference/dns-armor/rest/v1beta1/projects.locations.dnsThreatDetectors/list` | Lists DnsThreatDetectors in a given project and location. |
| ### `https://docs.cloud.google.com/dns/docs/reference/dns-armor/rest/v1beta1/projects.locations.dnsThreatDetectors/patch` | Updates a single DnsThreatDetector. |