google-cloud-network_security 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ae4b0d72db5624552aa469dc6e22d0a546c479698efa521fbbafa6b6cf3dce8
-  data.tar.gz: f7a999a15719c7a198e6b8959abc8ea895d7b4bbfededbdad33945533233b6d6
+  metadata.gz: b445a09a8fa47936ddfba4af33e958a85cc02898be087b26ba669c13f17ecb9e
+  data.tar.gz: ebfce621013318ee249411a73b44259e0ec02c1f6a8130d90fc6d83084a3cad8
 SHA512:
-  metadata.gz: 1857cf9caea95e3cfa9b2838d00d0f30d6042c8f0506a13ad53b52bdaa82c584510e461f83d358b770adb200315409cc4e54b921711d0cb48cad4841e3f0423b
-  data.tar.gz: f9c793eecc32961637208507e32e25d792657f397054280b5ecbd430fbf1ff4dedc9a74b90b61f0525a83d24842f3e0efab7233a30d33fc063fb29fb9d27cdd7
+  metadata.gz: bd74910e541dd01abfb211f13543fd95f6540434d3d00d2eb456fb3dd4f86f4f92985e97414d5b878308967adad0aba9a9b30cd85b5acfe2e8b258beeacb68e7
+  data.tar.gz: e43119a9d7d3d936edca9fcb7f0f761e165d920f95c4060ffec9050494f3402ee9f78bb7d69a621c76365bae05f20cfb3865d5e06c303865cc3f37525ace6e16

data/AUTHENTICATION.md

@@ -56,7 +56,7 @@ To configure a credentials file for an individual client initialization:
 ```ruby
 require "google/cloud/network_security"
 
-client = Google::Cloud::NetworkSecurity.network_security do |config|
+client = Google::Cloud::NetworkSecurity.dns_threat_detector_service do |config|
   config.credentials = "path/to/credentialfile.json"
 end
 ```
@@ -70,7 +70,7 @@ Google::Cloud::NetworkSecurity.configure do |config|
   config.credentials = "path/to/credentialfile.json"
 end
 
-client = Google::Cloud::NetworkSecurity.network_security
+client = Google::Cloud::NetworkSecurity.dns_threat_detector_service
 ```
 
 ### Environment Variables
@@ -100,7 +100,7 @@ require "google/cloud/network_security"
 
 ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
 
-client = Google::Cloud::NetworkSecurity.network_security
+client = Google::Cloud::NetworkSecurity.dns_threat_detector_service
 ```
 
 ### Local ADC file

data/README.md

@@ -37,9 +37,9 @@ In order to use this library, you first need to go through the following steps:
 ```ruby
 require "google/cloud/network_security"
 
-client = Google::Cloud::NetworkSecurity.network_security
-request = ::Google::Cloud::NetworkSecurity::V1beta1::ListAuthorizationPoliciesRequest.new # (request fields as keyword arguments...)
-response = client.list_authorization_policies request
+client = Google::Cloud::NetworkSecurity.dns_threat_detector_service
+request = ::Google::Cloud::NetworkSecurity::V1beta1::ListDnsThreatDetectorsRequest.new # (request fields as keyword arguments...)
+response = client.list_dns_threat_detectors request
 ```
 
 ## Debug Logging

data/lib/google/cloud/network_security/version.rb

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module NetworkSecurity
-      VERSION = "1.1.2"
+      VERSION = "1.2.0"
     end
   end
 end

data/lib/google/cloud/network_security.rb

@@ -45,6 +45,76 @@ end
 module Google
   module Cloud
     module NetworkSecurity
+      ##
+      # Create a new client object for DnsThreatDetectorService.
+      #
+      # By default, this returns an instance of
+      # [Google::Cloud::NetworkSecurity::V1beta1::DnsThreatDetectorService::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-network_security-v1beta1/latest/Google-Cloud-NetworkSecurity-V1beta1-DnsThreatDetectorService-Client)
+      # for a gRPC client for version V1beta1 of the API.
+      # However, you can specify a different API version by passing it in the
+      # `version` parameter. If the DnsThreatDetectorService service is
+      # supported by that API version, and the corresponding gem is available, the
+      # appropriate versioned client will be returned.
+      # You can also specify a different transport by passing `:rest` or `:grpc` in
+      # the `transport` parameter.
+      #
+      # Raises an exception if the currently installed versioned client gem for the
+      # given API version does not support the given transport of the DnsThreatDetectorService service.
+      # You can determine whether the method will succeed by calling
+      # {Google::Cloud::NetworkSecurity.dns_threat_detector_service_available?}.
+      #
+      # ## About DnsThreatDetectorService
+      #
+      # The Network Security API for DNS Threat Detectors.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1beta1`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [::Object] A client object for the specified version.
+      #
+      def self.dns_threat_detector_service version: :v1beta1, transport: :grpc, &block
+        require "google/cloud/network_security/#{version.to_s.downcase}"
+
+        package_name = Google::Cloud::NetworkSecurity
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        service_module = Google::Cloud::NetworkSecurity.const_get(package_name).const_get(:DnsThreatDetectorService)
+        service_module = service_module.const_get(:Rest) if transport == :rest
+        service_module.const_get(:Client).new(&block)
+      end
+
+      ##
+      # Determines whether the DnsThreatDetectorService service is supported by the current client.
+      # If true, you can retrieve a client object by calling {Google::Cloud::NetworkSecurity.dns_threat_detector_service}.
+      # If false, that method will raise an exception. This could happen if the given
+      # API version does not exist or does not support the DnsThreatDetectorService service,
+      # or if the versioned client gem needs an update to support the DnsThreatDetectorService service.
+      #
+      # @param version [::String, ::Symbol] The API version to connect to. Optional.
+      #   Defaults to `:v1beta1`.
+      # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
+      # @return [boolean] Whether the service is available.
+      #
+      def self.dns_threat_detector_service_available? version: :v1beta1, transport: :grpc
+        require "google/cloud/network_security/#{version.to_s.downcase}"
+        package_name = Google::Cloud::NetworkSecurity
+                       .constants
+                       .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
+                       .first
+        return false unless package_name
+        service_module = Google::Cloud::NetworkSecurity.const_get package_name
+        return false unless service_module.const_defined? :DnsThreatDetectorService
+        service_module = service_module.const_get :DnsThreatDetectorService
+        if transport == :rest
+          return false unless service_module.const_defined? :Rest
+          service_module = service_module.const_get :Rest
+        end
+        service_module.const_defined? :Client
+      rescue ::LoadError
+        false
+      end
+
       ##
       # Create a new client object for NetworkSecurity.
       #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-network_security
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Google LLC