google-cloud-monitoring 0.30.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13f6cb0ab0a29df0f3cb5ec7dfda375777b10454cc8c88a2059e2dc191414ef8
-  data.tar.gz: e2d7fe3847f9045f1b0f99996dee37a0f2bedc943e78276a7be213e289e3302c
+  metadata.gz: 8a4523eba78f675c7e693212d8224995806726976d0e8537b25ace18d35ebd83
+  data.tar.gz: d4c28ae689a85292d43ba97436af28cfbc171abc6f969cd9814bc5c64a7fed69
 SHA512:
-  metadata.gz: 9b6fa454660cdf7c7acfb91ebc263a373236fdf71358edcb8006fdeb8fad1533ba293ef0de6119ba198ad167614609bdbbb7a1f09102604f38b98ca1525b87f3
-  data.tar.gz: 8f86db7f8a59bca1ae593050a9bec61af7aa5b68552d00caa3404d5cc2f86b02af61fde6efc2aae0ddcb8366c243f80c2b2cf3a66b27f02413df569cae435a32
+  metadata.gz: 5cc452861113b8e14adf23f105f7fab5f1637db9005823aaed4b58fb1589d7de1d92233e38dcc560c18eb90565a619a59d94ac009d4c5ba9d29e20901c50c253
+  data.tar.gz: 8745006dfcdd48e36754f5a7e32cee48dd41be7dcc5f9bca2cbb9e963193f1c0d4b848fa791866db445d54214c33d0d58620ce62b943835cfc3c26404c695cd4

data/README.md

@@ -14,7 +14,7 @@ steps:
 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
 3. [Enable the Stackdriver Monitoring API.](https://console.cloud.google.com/apis/library/monitoring.googleapis.com)
-4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-monitoring/latest/file.AUTHENTICATION.html)
 
 ### Installation
 ```
@@ -51,14 +51,14 @@ end
 - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
   to see the full list of Cloud APIs that we cover.
 
-[Client Library Documentation]: https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-monitoring/latest/google/monitoring/v3
+[Client Library Documentation]: https://googleapis.dev/ruby/google-cloud-monitoring/latest
 [Product Documentation]: https://cloud.google.com/monitoring
 
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
 The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

data/lib/google/cloud/monitoring.rb

@@ -36,7 +36,7 @@ module Google
     # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
     # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
     # 3. [Enable the Stackdriver Monitoring API.](https://console.cloud.google.com/apis/library/monitoring.googleapis.com)
-    # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+    # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-monitoring/latest/file.AUTHENTICATION.html)
     #
     # ### Installation
     # ```
@@ -77,7 +77,7 @@ module Google
     #
     # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
     # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-    # or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
     # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
     # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
     #

data/lib/google/cloud/monitoring/v3.rb

@@ -42,7 +42,7 @@ module Google
       # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
       # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
       # 3. [Enable the Stackdriver Monitoring API.](https://console.cloud.google.com/apis/library/monitoring.googleapis.com)
-      # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+      # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-monitoring/latest/file.AUTHENTICATION.html)
       #
       # ### Installation
       # ```
@@ -83,7 +83,7 @@ module Google
       #
       # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
       # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
-      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+      # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
       # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
       # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
       #

data/lib/google/cloud/monitoring/v3/notification_channel_service_client.rb

@@ -290,6 +290,30 @@ module Google
                 {'name' => request.name}
               end
             )
+            @send_notification_channel_verification_code = Google::Gax.create_api_call(
+              @notification_channel_service_stub.method(:send_notification_channel_verification_code),
+              defaults["send_notification_channel_verification_code"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
+            @get_notification_channel_verification_code = Google::Gax.create_api_call(
+              @notification_channel_service_stub.method(:get_notification_channel_verification_code),
+              defaults["get_notification_channel_verification_code"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
+            @verify_notification_channel = Google::Gax.create_api_call(
+              @notification_channel_service_stub.method(:verify_notification_channel),
+              defaults["verify_notification_channel"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
           end
 
           # Service calls
@@ -629,6 +653,148 @@ module Google
             @delete_notification_channel.call(req, options, &block)
             nil
           end
+
+          # Causes a verification code to be delivered to the channel. The code
+          # can then be supplied in `VerifyNotificationChannel` to verify the channel.
+          #
+          # @param name [String]
+          #   The notification channel to which to send a verification code.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result []
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/monitoring"
+          #
+          #   notification_channel_client = Google::Cloud::Monitoring::NotificationChannel.new(version: :v3)
+          #   formatted_name = Google::Cloud::Monitoring::V3::NotificationChannelServiceClient.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+          #   notification_channel_client.send_notification_channel_verification_code(formatted_name)
+
+          def send_notification_channel_verification_code \
+              name,
+              options: nil,
+              &block
+            req = {
+              name: name
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::SendNotificationChannelVerificationCodeRequest)
+            @send_notification_channel_verification_code.call(req, options, &block)
+            nil
+          end
+
+          # Requests a verification code for an already verified channel that can then
+          # be used in a call to VerifyNotificationChannel() on a different channel
+          # with an equivalent identity in the same or in a different project. This
+          # makes it possible to copy a channel between projects without requiring
+          # manual reverification of the channel. If the channel is not in the
+          # verified state, this method will fail (in other words, this may only be
+          # used if the SendNotificationChannelVerificationCode and
+          # VerifyNotificationChannel paths have already been used to put the given
+          # channel into the verified state).
+          #
+          # There is no guarantee that the verification codes returned by this method
+          # will be of a similar structure or form as the ones that are delivered
+          # to the channel via SendNotificationChannelVerificationCode; while
+          # VerifyNotificationChannel() will recognize both the codes delivered via
+          # SendNotificationChannelVerificationCode() and returned from
+          # GetNotificationChannelVerificationCode(), it is typically the case that
+          # the verification codes delivered via
+          # SendNotificationChannelVerificationCode() will be shorter and also
+          # have a shorter expiration (e.g. codes such as "G-123456") whereas
+          # GetVerificationCode() will typically return a much longer, websafe base
+          # 64 encoded string that has a longer expiration time.
+          #
+          # @param name [String]
+          #   The notification channel for which a verification code is to be generated
+          #   and retrieved. This must name a channel that is already verified; if
+          #   the specified channel is not verified, the request will fail.
+          # @param expire_time [Google::Protobuf::Timestamp | Hash]
+          #   The desired expiration time. If specified, the API will guarantee that
+          #   the returned code will not be valid after the specified timestamp;
+          #   however, the API cannot guarantee that the returned code will be
+          #   valid for at least as long as the requested time (the API puts an upper
+          #   bound on the amount of time for which a code may be valid). If omitted,
+          #   a default expiration will be used, which may be less than the max
+          #   permissible expiration (so specifying an expiration may extend the
+          #   code's lifetime over omitting an expiration, even though the API does
+          #   impose an upper limit on the maximum expiration that is permitted).
+          #   A hash of the same form as `Google::Protobuf::Timestamp`
+          #   can also be provided.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Monitoring::V3::GetNotificationChannelVerificationCodeResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Monitoring::V3::GetNotificationChannelVerificationCodeResponse]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/monitoring"
+          #
+          #   notification_channel_client = Google::Cloud::Monitoring::NotificationChannel.new(version: :v3)
+          #   formatted_name = Google::Cloud::Monitoring::V3::NotificationChannelServiceClient.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+          #   response = notification_channel_client.get_notification_channel_verification_code(formatted_name)
+
+          def get_notification_channel_verification_code \
+              name,
+              expire_time: nil,
+              options: nil,
+              &block
+            req = {
+              name: name,
+              expire_time: expire_time
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::GetNotificationChannelVerificationCodeRequest)
+            @get_notification_channel_verification_code.call(req, options, &block)
+          end
+
+          # Verifies a `NotificationChannel` by proving receipt of the code
+          # delivered to the channel as a result of calling
+          # `SendNotificationChannelVerificationCode`.
+          #
+          # @param name [String]
+          #   The notification channel to verify.
+          # @param code [String]
+          #   The verification code that was delivered to the channel as
+          #   a result of invoking the `SendNotificationChannelVerificationCode` API
+          #   method or that was retrieved from a verified channel via
+          #   `GetNotificationChannelVerificationCode`. For example, one might have
+          #   "G-123456" or "TKNZGhhd2EyN3I1MnRnMjRv" (in general, one is only
+          #   guaranteed that the code is valid UTF-8; one should not
+          #   make any assumptions regarding the structure or format of the code).
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Monitoring::V3::NotificationChannel]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Monitoring::V3::NotificationChannel]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/monitoring"
+          #
+          #   notification_channel_client = Google::Cloud::Monitoring::NotificationChannel.new(version: :v3)
+          #   formatted_name = Google::Cloud::Monitoring::V3::NotificationChannelServiceClient.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+          #
+          #   # TODO: Initialize `code`:
+          #   code = ''
+          #   response = notification_channel_client.verify_notification_channel(formatted_name, code)
+
+          def verify_notification_channel \
+              name,
+              code,
+              options: nil,
+              &block
+            req = {
+              name: name,
+              code: code
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Monitoring::V3::VerifyNotificationChannelRequest)
+            @verify_notification_channel.call(req, options, &block)
+          end
         end
       end
     end

data/lib/google/cloud/monitoring/v3/notification_channel_service_client_config.json

@@ -54,6 +54,21 @@
           "timeout_millis": 30000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
+        },
+        "SendNotificationChannelVerificationCode": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "GetNotificationChannelVerificationCode": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "VerifyNotificationChannel": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
         }
       }
     }

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Monitoring
-      VERSION = "0.30.0".freeze
+      VERSION = "0.31.0".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-monitoring
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.31.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-09 00:00:00.000000000 Z
+date: 2019-08-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax
@@ -196,7 +196,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.4
 signing_key: 
 specification_version: 4
 summary: API Client library for Stackdriver Monitoring API