google-cloud-monitoring 0.29.3 → 0.29.4

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

@@ -186,8 +186,10 @@ module Google
           #     are applied in the order specified.
           #
           #     This field is similar to the one in the
-          #     [`MetricService.ListTimeSeries` request](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).
-          #     It is advisable to use the `ListTimeSeries` method when debugging this field.
+          #     [`MetricService.ListTimeSeries`
+          #     request](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). It
+          #     is advisable to use the `ListTimeSeries` method when debugging this
+          #     field.
           # @!attribute [rw] denominator_filter
           #   @return [String]
           #     A [filter](https://cloud.google.com/monitoring/api/v3/filters) that identifies a time
@@ -281,8 +283,10 @@ module Google
           #     are applied in the order specified.
           #
           #     This field is similar to the
-          #     one in the [`MetricService.ListTimeSeries` request](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).
-          #     It is advisable to use the `ListTimeSeries` method when debugging this field.
+          #     one in the [`MetricService.ListTimeSeries`
+          #     request](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). It
+          #     is advisable to use the `ListTimeSeries` method when debugging this
+          #     field.
           # @!attribute [rw] duration
           #   @return [Google::Protobuf::Duration]
           #     The amount of time that a time series must fail to report new

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

@@ -376,8 +376,9 @@ module Google
       end
 
       # The tier of service for a Workspace. Please see the
-      # [service tiers documentation](https://cloud.google.com/monitoring/workspaces/tiers)
-      # for more details.
+      # [service tiers
+      # documentation](https://cloud.google.com/monitoring/workspaces/tiers) for more
+      # details.
       module ServiceTier
         # An invalid sentinel value, used to indicate that a tier has not
         # been provided explicitly.
@@ -386,13 +387,15 @@ module Google
         # The Stackdriver Basic tier, a free tier of service that provides basic
         # features, a moderate allotment of logs, and access to built-in metrics.
         # A number of features are not available in this tier. For more details,
-        # see [the service tiers documentation](https://cloud.google.com/monitoring/workspaces/tiers).
+        # see [the service tiers
+        # documentation](https://cloud.google.com/monitoring/workspaces/tiers).
         SERVICE_TIER_BASIC = 1
 
         # The Stackdriver Premium tier, a higher, more expensive tier of service
         # that provides access to all Stackdriver features, lets you use Stackdriver
         # with AWS accounts, and has a larger allotments for logs and metrics. For
-        # more details, see [the service tiers documentation](https://cloud.google.com/monitoring/workspaces/tiers).
+        # more details, see [the service tiers
+        # documentation](https://cloud.google.com/monitoring/workspaces/tiers).
         SERVICE_TIER_PREMIUM = 2
       end
     end

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

@@ -59,7 +59,8 @@ module Google
       #     For groups with no parent, `parentName` is the empty string, `""`.
       # @!attribute [rw] filter
       #   @return [String]
-      #     The filter used to determine which monitored resources belong to this group.
+      #     The filter used to determine which monitored resources belong to this
+      #     group.
       # @!attribute [rw] is_cluster
       #   @return [true, false]
       #     If true, the members of this group are considered to be a cluster.

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

@@ -58,7 +58,9 @@ module Google
       # @!attribute [rw] type
       #   @return [String]
       #     The type of the notification channel. This field matches the
-      #     value of the {Google::Monitoring::V3::NotificationChannelDescriptor#type NotificationChannelDescriptor#type} field.
+      #     value of the
+      #     {Google::Monitoring::V3::NotificationChannelDescriptor#type NotificationChannelDescriptor#type}
+      #     field.
       # @!attribute [rw] name
       #   @return [String]
       #     The full REST resource name for this channel. The syntax is:
@@ -81,8 +83,8 @@ module Google
       #   @return [Hash{String => String}]
       #     Configuration fields that define the channel and its behavior. The
       #     permissible and required labels are specified in the
-      #     {Google::Monitoring::V3::NotificationChannelDescriptor#labels NotificationChannelDescriptor#labels} of the
-      #     `NotificationChannelDescriptor` corresponding to the `type` field.
+      #     {Google::Monitoring::V3::NotificationChannelDescriptor#labels NotificationChannelDescriptor#labels}
+      #     of the `NotificationChannelDescriptor` corresponding to the `type` field.
       # @!attribute [rw] user_labels
       #   @return [Hash{String => String}]
       #     User-supplied key/value data that does not need to conform to

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

@@ -84,7 +84,8 @@ module Google
       #     in which to look for the notification channels; it does not name a
       #     specific channel. To query a specific channel by REST resource name, use
       #     the
-      #     {Google::Monitoring::V3::NotificationChannelService::GetNotificationChannel `GetNotificationChannel`} operation.
+      #     {Google::Monitoring::V3::NotificationChannelService::GetNotificationChannel `GetNotificationChannel`}
+      #     operation.
       # @!attribute [rw] filter
       #   @return [String]
       #     If provided, this field specifies the criteria that must be met by

data/lib/google/cloud/monitoring/v3/doc/google/protobuf/any.rb

@@ -97,7 +97,8 @@ module Google
     # @!attribute [rw] type_url
     #   @return [String]
     #     A URL/resource name that uniquely identifies the type of the serialized
-    #     protocol buffer message. The last segment of the URL's path must represent
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
     #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).

data/lib/google/cloud/monitoring/v3/doc/google/protobuf/field_mask.rb

@@ -83,57 +83,49 @@ module Google
     # describe the updated values, the API ignores the values of all
     # fields not covered by the mask.
     #
-    # If a repeated field is specified for an update operation, the existing
-    # repeated values in the target resource will be overwritten by the new values.
-    # Note that a repeated field is only allowed in the last position of a `paths`
-    # string.
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
     #
     # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then the existing sub-message in the target resource is
-    # overwritten. Given the target message:
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
     #
     #     f {
     #       b {
-    #         d : 1
-    #         x : 2
+    #         d: 1
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1]
     #     }
     #
     # And an update message:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
     #       }
+    #       c: [2]
     #     }
     #
     # then if the field mask is:
     #
-    #  paths: "f.b"
+    #  paths: ["f.b", "f.c"]
     #
     # then the result will be:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1, 2]
     #     }
     #
-    # However, if the update mask was:
-    #
-    #  paths: "f.b.d"
-    #
-    # then the result would be:
-    #
-    #     f {
-    #       b {
-    #         d : 10
-    #         x : 2
-    #       }
-    #       c : 1
-    #     }
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
     #
     # In order to reset a field's value to the default, the field must
     # be in the mask and set to the default value in the provided resource.

data/lib/google/cloud/monitoring/v3/doc/google/protobuf/timestamp.rb

@@ -15,17 +15,19 @@
 
 module Google
   module Protobuf
-    # A Timestamp represents a point in time independent of any time zone
-    # or calendar, represented as seconds and fractions of seconds at
-    # nanosecond resolution in UTC Epoch time. It is encoded using the
-    # Proleptic Gregorian Calendar which extends the Gregorian calendar
-    # backwards to year one. It is encoded assuming all minutes are 60
-    # seconds long, i.e. leap seconds are "smeared" so that no leap second
-    # table is needed for interpretation. Range is from
-    # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
-    # By restricting to that range, we ensure that we can convert to
-    # and from  RFC 3339 date strings.
-    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
     #
     # = Examples
     #
@@ -86,12 +88,12 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
     # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
     # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]

data/lib/google/cloud/monitoring/v3/doc/google/rpc/status.rb

@@ -15,24 +15,25 @@
 
 module Google
   module Rpc
-    # The `Status` type defines a logical error model that is suitable for different
-    # programming environments, including REST APIs and RPC APIs. It is used by
-    # [gRPC](https://github.com/grpc). The error model is designed to be:
+    # The `Status` type defines a logical error model that is suitable for
+    # different programming environments, including REST APIs and RPC APIs. It is
+    # used by [gRPC](https://github.com/grpc). The error model is designed to be:
     #
     # * Simple to use and understand for most users
     # * Flexible enough to meet unexpected needs
     #
     # = Overview
     #
-    # The `Status` message contains three pieces of data: error code, error message,
-    # and error details. The error code should be an enum value of
-    # {Google::Rpc::Code}, but it may accept additional error codes if needed.  The
-    # error message should be a developer-facing English message that helps
-    # developers *understand* and *resolve* the error. If a localized user-facing
-    # error message is needed, put the localized message in the error details or
-    # localize it in the client. The optional error details may contain arbitrary
-    # information about the error. There is a predefined set of error detail types
-    # in the package `google.rpc` that can be used for common error conditions.
+    # The `Status` message contains three pieces of data: error code, error
+    # message, and error details. The error code should be an enum value of
+    # {Google::Rpc::Code}, but it may accept additional error codes
+    # if needed.  The error message should be a developer-facing English message
+    # that helps developers *understand* and *resolve* the error. If a localized
+    # user-facing error message is needed, put the localized message in the error
+    # details or localize it in the client. The optional error details may contain
+    # arbitrary information about the error. There is a predefined set of error
+    # detail types in the package `google.rpc` that can be used for common error
+    # conditions.
     #
     # = Language mapping
     #
@@ -69,12 +70,14 @@ module Google
     #   be used directly after any stripping needed for security/privacy reasons.
     # @!attribute [rw] code
     #   @return [Integer]
-    #     The status code, which should be an enum value of {Google::Rpc::Code}.
+    #     The status code, which should be an enum value of
+    #     {Google::Rpc::Code}.
     # @!attribute [rw] message
     #   @return [String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {Google::Rpc::Status#details} field, or localized by the client.
+    #     {Google::Rpc::Status#details} field, or localized
+    #     by the client.
     # @!attribute [rw] details
     #   @return [Array<Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

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

@@ -85,26 +85,17 @@ module Google
           ].freeze
 
 
-          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}"
-          )
-
-          private_constant :PROJECT_PATH_TEMPLATE
-
           GROUP_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/groups/{group}"
           )
 
           private_constant :GROUP_PATH_TEMPLATE
 
-          # Returns a fully-qualified project resource name string.
-          # @param project [String]
-          # @return [String]
-          def self.project_path project
-            PROJECT_PATH_TEMPLATE.render(
-              :"project" => project
-            )
-          end
+          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}"
+          )
+
+          private_constant :PROJECT_PATH_TEMPLATE
 
           # Returns a fully-qualified group resource name string.
           # @param project [String]
@@ -117,6 +108,15 @@ module Google
             )
           end
 
+          # Returns a fully-qualified project resource name string.
+          # @param project [String]
+          # @return [String]
+          def self.project_path project
+            PROJECT_PATH_TEMPLATE.render(
+              :"project" => project
+            )
+          end
+
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -223,32 +223,50 @@ module Google
             @list_groups = Google::Gax.create_api_call(
               @group_service_stub.method(:list_groups),
               defaults["list_groups"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @get_group = Google::Gax.create_api_call(
               @group_service_stub.method(:get_group),
               defaults["get_group"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @create_group = Google::Gax.create_api_call(
               @group_service_stub.method(:create_group),
               defaults["create_group"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @update_group = Google::Gax.create_api_call(
               @group_service_stub.method(:update_group),
               defaults["update_group"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'group.name' => request.group.name}
+              end
             )
             @delete_group = Google::Gax.create_api_call(
               @group_service_stub.method(:delete_group),
               defaults["delete_group"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @list_group_members = Google::Gax.create_api_call(
               @group_service_stub.method(:list_group_members),
               defaults["list_group_members"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
           end
 
@@ -295,16 +313,16 @@ module Google
           # @example
           #   require "google/cloud/monitoring"
           #
-          #   group_service_client = Google::Cloud::Monitoring::Group.new(version: :v3)
+          #   group_client = Google::Cloud::Monitoring::Group.new(version: :v3)
           #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.project_path("[PROJECT]")
           #
           #   # Iterate over all results.
-          #   group_service_client.list_groups(formatted_name).each do |element|
+          #   group_client.list_groups(formatted_name).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   group_service_client.list_groups(formatted_name).each_page do |page|
+          #   group_client.list_groups(formatted_name).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -346,9 +364,9 @@ module Google
           # @example
           #   require "google/cloud/monitoring"
           #
-          #   group_service_client = Google::Cloud::Monitoring::Group.new(version: :v3)
+          #   group_client = Google::Cloud::Monitoring::Group.new(version: :v3)
           #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
-          #   response = group_service_client.get_group(formatted_name)
+          #   response = group_client.get_group(formatted_name)
 
           def get_group \
               name,
@@ -384,12 +402,12 @@ module Google
           # @example
           #   require "google/cloud/monitoring"
           #
-          #   group_service_client = Google::Cloud::Monitoring::Group.new(version: :v3)
+          #   group_client = Google::Cloud::Monitoring::Group.new(version: :v3)
           #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.project_path("[PROJECT]")
           #
           #   # TODO: Initialize `group`:
           #   group = {}
-          #   response = group_service_client.create_group(formatted_name, group)
+          #   response = group_client.create_group(formatted_name, group)
 
           def create_group \
               name,
@@ -427,11 +445,11 @@ module Google
           # @example
           #   require "google/cloud/monitoring"
           #
-          #   group_service_client = Google::Cloud::Monitoring::Group.new(version: :v3)
+          #   group_client = Google::Cloud::Monitoring::Group.new(version: :v3)
           #
           #   # TODO: Initialize `group`:
           #   group = {}
-          #   response = group_service_client.update_group(group)
+          #   response = group_client.update_group(group)
 
           def update_group \
               group,
@@ -461,9 +479,9 @@ module Google
           # @example
           #   require "google/cloud/monitoring"
           #
-          #   group_service_client = Google::Cloud::Monitoring::Group.new(version: :v3)
+          #   group_client = Google::Cloud::Monitoring::Group.new(version: :v3)
           #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
-          #   group_service_client.delete_group(formatted_name)
+          #   group_client.delete_group(formatted_name)
 
           def delete_group \
               name,
@@ -518,16 +536,16 @@ module Google
           # @example
           #   require "google/cloud/monitoring"
           #
-          #   group_service_client = Google::Cloud::Monitoring::Group.new(version: :v3)
+          #   group_client = Google::Cloud::Monitoring::Group.new(version: :v3)
           #   formatted_name = Google::Cloud::Monitoring::V3::GroupServiceClient.group_path("[PROJECT]", "[GROUP]")
           #
           #   # Iterate over all results.
-          #   group_service_client.list_group_members(formatted_name).each do |element|
+          #   group_client.list_group_members(formatted_name).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   group_service_client.list_group_members(formatted_name).each_page do |page|
+          #   group_client.list_group_members(formatted_name).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.