create(parent, body=None, dnsThreatDetectorId=None, x__xgafv=None)

Creates a new DnsThreatDetector in a given project and location.

Args:
  parent: string, Required. The value for the parent of the DnsThreatDetector resource. (required)
  body: object, The request body.
    The object takes the form of:

{ # A DNS threat detector sends DNS query logs to a _provider_ that then analyzes the logs to identify malicious activity in the DNS queries. By default, all VPC networks in your projects are included. You can exclude specific networks by supplying `excluded_networks`.
  "createTime": "A String", # Output only. Create time stamp.
  "excludedNetworks": [ # Optional. A list of network resource names which aren't monitored by this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
    "A String",
  ],
  "labels": { # Optional. Any labels associated with the DnsThreatDetector, listed as key value pairs.
    "a_key": "A String",
  },
  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
  "provider": "A String", # Required. The provider used for DNS threat analysis.
  "updateTime": "A String", # Output only. Update time stamp.
}

  dnsThreatDetectorId: string, Optional. The ID of the requesting DnsThreatDetector object. If this field is not supplied, the service generates an identifier.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A DNS threat detector sends DNS query logs to a _provider_ that then analyzes the logs to identify malicious activity in the DNS queries. By default, all VPC networks in your projects are included. You can exclude specific networks by supplying `excluded_networks`.
  "createTime": "A String", # Output only. Create time stamp.
  "excludedNetworks": [ # Optional. A list of network resource names which aren't monitored by this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
    "A String",
  ],
  "labels": { # Optional. Any labels associated with the DnsThreatDetector, listed as key value pairs.
    "a_key": "A String",
  },
  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
  "provider": "A String", # Required. The provider used for DNS threat analysis.
  "updateTime": "A String", # Output only. Update time stamp.
}

delete(name, x__xgafv=None)

Deletes a single DnsThreatDetector.

Args:
  name: string, Required. Name of the DnsThreatDetector resource. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}

get(name, x__xgafv=None)

Gets the details of a single DnsThreatDetector.

Args:
  name: string, Required. Name of the DnsThreatDetector resource. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A DNS threat detector sends DNS query logs to a _provider_ that then analyzes the logs to identify malicious activity in the DNS queries. By default, all VPC networks in your projects are included. You can exclude specific networks by supplying `excluded_networks`.
  "createTime": "A String", # Output only. Create time stamp.
  "excludedNetworks": [ # Optional. A list of network resource names which aren't monitored by this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
    "A String",
  ],
  "labels": { # Optional. Any labels associated with the DnsThreatDetector, listed as key value pairs.
    "a_key": "A String",
  },
  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
  "provider": "A String", # Required. The provider used for DNS threat analysis.
  "updateTime": "A String", # Output only. Update time stamp.
}

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists DnsThreatDetectors in a given project and location.

Args:
  parent: string, Required. The parent value for `ListDnsThreatDetectorsRequest`. (required)
  pageSize: integer, Optional. The requested page size. The server may return fewer items than requested. If unspecified, the server picks an appropriate default.
  pageToken: string, Optional. A page token received from a previous `ListDnsThreatDetectorsRequest` call. Provide this to retrieve the subsequent page.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The response message to requesting a list of DnsThreatDetectors.
  "dnsThreatDetectors": [ # The list of DnsThreatDetector resources.
    { # A DNS threat detector sends DNS query logs to a _provider_ that then analyzes the logs to identify malicious activity in the DNS queries. By default, all VPC networks in your projects are included. You can exclude specific networks by supplying `excluded_networks`.
      "createTime": "A String", # Output only. Create time stamp.
      "excludedNetworks": [ # Optional. A list of network resource names which aren't monitored by this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
        "A String",
      ],
      "labels": { # Optional. Any labels associated with the DnsThreatDetector, listed as key value pairs.
        "a_key": "A String",
      },
      "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
      "provider": "A String", # Required. The provider used for DNS threat analysis.
      "updateTime": "A String", # Output only. Update time stamp.
    },
  ],
  "nextPageToken": "A String", # A token, which can be sent as `page_token`, to retrieve the next page.
  "unreachable": [ # Unordered list. Unreachable `DnsThreatDetector` resources.
    "A String",
  ],
}

list_next()

Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.

patch(name, body=None, updateMask=None, x__xgafv=None)

Updates a single DnsThreatDetector.

Args:
  name: string, Immutable. Identifier. Name of the DnsThreatDetector resource. (required)
  body: object, The request body.
    The object takes the form of:

{ # A DNS threat detector sends DNS query logs to a _provider_ that then analyzes the logs to identify malicious activity in the DNS queries. By default, all VPC networks in your projects are included. You can exclude specific networks by supplying `excluded_networks`.
  "createTime": "A String", # Output only. Create time stamp.
  "excludedNetworks": [ # Optional. A list of network resource names which aren't monitored by this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
    "A String",
  ],
  "labels": { # Optional. Any labels associated with the DnsThreatDetector, listed as key value pairs.
    "a_key": "A String",
  },
  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
  "provider": "A String", # Required. The provider used for DNS threat analysis.
  "updateTime": "A String", # Output only. Update time stamp.
}

  updateMask: string, Optional. The field mask is used to specify the fields to be overwritten in the DnsThreatDetector resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the mask is not provided then all fields present in the request will be overwritten.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A DNS threat detector sends DNS query logs to a _provider_ that then analyzes the logs to identify malicious activity in the DNS queries. By default, all VPC networks in your projects are included. You can exclude specific networks by supplying `excluded_networks`.
  "createTime": "A String", # Output only. Create time stamp.
  "excludedNetworks": [ # Optional. A list of network resource names which aren't monitored by this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
    "A String",
  ],
  "labels": { # Optional. Any labels associated with the DnsThreatDetector, listed as key value pairs.
    "a_key": "A String",
  },
  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
  "provider": "A String", # Required. The provider used for DNS threat analysis.
  "updateTime": "A String", # Output only. Update time stamp.
}

Network Security API . projects . locations . dnsThreatDetectors

Instance Methods

Method Details