google-cloud-monitoring 0.34.2 → 0.35.0

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

@@ -19,7 +19,7 @@ module Google
       # The `ListGroup` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project whose groups are to be listed. The format is
+      #     Required. The project whose groups are to be listed. The format is
       #     `"projects/{project_id_or_number}"`.
       # @!attribute [rw] children_of_group
       #   @return [String]
@@ -63,18 +63,18 @@ module Google
       # The `GetGroup` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The group to retrieve. The format is
+      #     Required. The group to retrieve. The format is
       #     `"projects/{project_id_or_number}/groups/{group_id}"`.
       class GetGroupRequest; end
 
       # The `CreateGroup` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project in which to create the group. The format is
+      #     Required. The project in which to create the group. The format is
       #     `"projects/{project_id_or_number}"`.
       # @!attribute [rw] group
       #   @return [Google::Monitoring::V3::Group]
-      #     A group definition. It is an error to define the `name` field because
+      #     Required. A group definition. It is an error to define the `name` field because
       #     the system assigns the name.
       # @!attribute [rw] validate_only
       #   @return [true, false]
@@ -84,7 +84,7 @@ module Google
       # The `UpdateGroup` request.
       # @!attribute [rw] group
       #   @return [Google::Monitoring::V3::Group]
-      #     The new definition of the group.  All fields of the existing group,
+      #     Required. The new definition of the group.  All fields of the existing group,
       #     excepting `name`, are replaced with the corresponding fields of this group.
       # @!attribute [rw] validate_only
       #   @return [true, false]
@@ -95,7 +95,7 @@ module Google
       # single group without any descendants.
       # @!attribute [rw] name
       #   @return [String]
-      #     The group to delete. The format is
+      #     Required. The group to delete. The format is
       #     `"projects/{project_id_or_number}/groups/{group_id}"`.
       # @!attribute [rw] recursive
       #   @return [true, false]
@@ -107,7 +107,7 @@ module Google
       # The `ListGroupMembers` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The group whose members are listed. The format is
+      #     Required. The group whose members are listed. The format is
       #     `"projects/{project_id_or_number}/groups/{group_id}"`.
       # @!attribute [rw] page_size
       #   @return [Integer]

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

@@ -19,7 +19,7 @@ module Google
       # The `ListMonitoredResourceDescriptors` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project on which to execute the request. The format is
+      #     Required. The project on which to execute the request. The format is
       #     `"projects/{project_id_or_number}"`.
       # @!attribute [rw] filter
       #   @return [String]
@@ -55,7 +55,7 @@ module Google
       # The `GetMonitoredResourceDescriptor` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The monitored resource descriptor to get.  The format is
+      #     Required. The monitored resource descriptor to get.  The format is
       #     `"projects/{project_id_or_number}/monitoredResourceDescriptors/{resource_type}"`.
       #     The `{resource_type}` is a predefined type, such as
       #     `cloudsql_database`.
@@ -64,7 +64,7 @@ module Google
       # The `ListMetricDescriptors` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project on which to execute the request. The format is
+      #     Required. The project on which to execute the request. The format is
       #     `"projects/{project_id_or_number}"`.
       # @!attribute [rw] filter
       #   @return [String]
@@ -101,7 +101,7 @@ module Google
       # The `GetMetricDescriptor` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The metric descriptor on which to execute the request. The format is
+      #     Required. The metric descriptor on which to execute the request. The format is
       #     `"projects/{project_id_or_number}/metricDescriptors/{metric_id}"`.
       #     An example value of `{metric_id}` is
       #     `"compute.googleapis.com/instance/disk/read_bytes_count"`.
@@ -110,18 +110,18 @@ module Google
       # The `CreateMetricDescriptor` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project on which to execute the request. The format is
+      #     Required. The project on which to execute the request. The format is
       #     `"projects/{project_id_or_number}"`.
       # @!attribute [rw] metric_descriptor
       #   @return [Google::Api::MetricDescriptor]
-      #     The new [custom metric](https://cloud.google.com/monitoring/custom-metrics)
+      #     Required. The new [custom metric](https://cloud.google.com/monitoring/custom-metrics)
       #     descriptor.
       class CreateMetricDescriptorRequest; end
 
       # The `DeleteMetricDescriptor` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The metric descriptor on which to execute the request. The format is
+      #     Required. The metric descriptor on which to execute the request. The format is
       #     `"projects/{project_id_or_number}/metricDescriptors/{metric_id}"`.
       #     An example of `{metric_id}` is:
       #     `"custom.googleapis.com/my_test_metric"`.
@@ -130,11 +130,11 @@ module Google
       # The `ListTimeSeries` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project on which to execute the request. The format is
+      #     Required. The project on which to execute the request. The format is
       #     "projects/\\{project_id_or_number}".
       # @!attribute [rw] filter
       #   @return [String]
-      #     A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters) that specifies which time
+      #     Required. A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters) that specifies which time
       #     series should be returned.  The filter must specify a single metric type,
       #     and can additionally specify metric labels and other information. For
       #     example:
@@ -143,7 +143,7 @@ module Google
       #             metric.labels.instance_name = "my-instance-name"
       # @!attribute [rw] interval
       #   @return [Google::Monitoring::V3::TimeInterval]
-      #     The time interval for which results should be returned. Only time series
+      #     Required. The time interval for which results should be returned. Only time series
       #     that contain data points in the specified interval are included
       #     in the response.
       # @!attribute [rw] aggregation
@@ -159,7 +159,7 @@ module Google
       #     currently returned in reverse time order (most recent to oldest).
       # @!attribute [rw] view
       #   @return [Google::Monitoring::V3::ListTimeSeriesRequest::TimeSeriesView]
-      #     Specifies which information is returned about the time series.
+      #     Required. Specifies which information is returned about the time series.
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     A positive number that is the maximum number of results to return. If
@@ -203,11 +203,11 @@ module Google
       # The `CreateTimeSeries` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project on which to execute the request. The format is
+      #     Required. The project on which to execute the request. The format is
       #     `"projects/{project_id_or_number}"`.
       # @!attribute [rw] time_series
       #   @return [Array<Google::Monitoring::V3::TimeSeries>]
-      #     The new data to be added to a list of time series.
+      #     Required. The new data to be added to a list of time series.
       #     Adds at most one data point to each of several time series.  The new data
       #     point must be more recent than any other point in its time series.  Each
       #     `TimeSeries` value must fully specify a unique time series by supplying

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

@@ -48,6 +48,9 @@ module Google
       #   @return [Array<Google::Monitoring::V3::ServiceTier>]
       #     The tiers that support this notification channel; the project service tier
       #     must be one of the supported_tiers.
+      # @!attribute [rw] launch_stage
+      #   @return [Google::Api::LaunchStage]
+      #     The product launch stage for channels of this type.
       class NotificationChannelDescriptor; end
 
       # A `NotificationChannel` is a medium through which an alert is

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

@@ -19,7 +19,7 @@ module Google
       # The `ListNotificationChannelDescriptors` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The REST resource name of the parent from which to retrieve
+      #     Required. The REST resource name of the parent from which to retrieve
       #     the notification channel descriptors. The expected syntax is:
       #
       #         projects/[PROJECT_ID]
@@ -56,14 +56,14 @@ module Google
       # The `GetNotificationChannelDescriptor` response.
       # @!attribute [rw] name
       #   @return [String]
-      #     The channel type for which to execute the request. The format is
+      #     Required. The channel type for which to execute the request. The format is
       #     `projects/[PROJECT_ID]/notificationChannelDescriptors/{channel_type}`.
       class GetNotificationChannelDescriptorRequest; end
 
       # The `CreateNotificationChannel` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project on which to execute the request. The format is:
+      #     Required. The project on which to execute the request. The format is:
       #
       #         projects/[PROJECT_ID]
       #
@@ -73,13 +73,13 @@ module Google
       #     but will add `/notificationChannels/[CHANNEL_ID]` to identify the channel.
       # @!attribute [rw] notification_channel
       #   @return [Google::Monitoring::V3::NotificationChannel]
-      #     The definition of the `NotificationChannel` to create.
+      #     Required. The definition of the `NotificationChannel` to create.
       class CreateNotificationChannelRequest; end
 
       # The `ListNotificationChannels` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The project on which to execute the request. The format is
+      #     Required. The project on which to execute the request. The format is
       #     `projects/[PROJECT_ID]`. That is, this names the container
       #     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
@@ -128,7 +128,7 @@ module Google
       # The `GetNotificationChannel` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The channel for which to execute the request. The format is
+      #     Required. The channel for which to execute the request. The format is
       #     `projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]`.
       class GetNotificationChannelRequest; end
 
@@ -138,7 +138,7 @@ module Google
       #     The fields to update.
       # @!attribute [rw] notification_channel
       #   @return [Google::Monitoring::V3::NotificationChannel]
-      #     A description of the changes to be applied to the specified
+      #     Required. A description of the changes to be applied to the specified
       #     notification channel. The description must provide a definition for
       #     fields to be updated; the names of these fields should also be
       #     included in the `update_mask`.
@@ -147,7 +147,7 @@ module Google
       # The `DeleteNotificationChannel` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The channel for which to execute the request. The format is
+      #     Required. The channel for which to execute the request. The format is
       #     `projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]`.
       # @!attribute [rw] force
       #   @return [true, false]
@@ -160,13 +160,13 @@ module Google
       # The `SendNotificationChannelVerificationCode` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The notification channel to which to send a verification code.
+      #     Required. The notification channel to which to send a verification code.
       class SendNotificationChannelVerificationCodeRequest; end
 
       # The `GetNotificationChannelVerificationCode` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The notification channel for which a verification code is to be generated
+      #     Required. 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.
       # @!attribute [rw] expire_time
@@ -199,10 +199,10 @@ module Google
       # The `VerifyNotificationChannel` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The notification channel to verify.
+      #     Required. The notification channel to verify.
       # @!attribute [rw] code
       #   @return [String]
-      #     The verification code that was delivered to the channel as
+      #     Required. 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

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

@@ -19,7 +19,7 @@ module Google
       # The `CreateService` request.
       # @!attribute [rw] parent
       #   @return [String]
-      #     Resource name of the parent workspace.
+      #     Required. Resource name of the parent workspace.
       #     Of the form `projects/{project_id}`.
       # @!attribute [rw] service_id
       #   @return [String]
@@ -27,20 +27,20 @@ module Google
       #     generated instead. Must match the pattern [a-z0-9\-]+
       # @!attribute [rw] service
       #   @return [Google::Monitoring::V3::Service]
-      #     The `Service` to create.
+      #     Required. The `Service` to create.
       class CreateServiceRequest; end
 
       # The `GetService` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     Resource name of the `Service`.
+      #     Required. Resource name of the `Service`.
       #     Of the form `projects/{project_id}/services/{service_id}`.
       class GetServiceRequest; end
 
       # The `ListServices` request.
       # @!attribute [rw] parent
       #   @return [String]
-      #     Resource name of the parent `Workspace`.
+      #     Required. Resource name of the parent `Workspace`.
       #     Of the form `projects/{project_id}`.
       # @!attribute [rw] filter
       #   @return [String]
@@ -84,7 +84,7 @@ module Google
       # The `UpdateService` request.
       # @!attribute [rw] service
       #   @return [Google::Monitoring::V3::Service]
-      #     The `Service` to draw updates from.
+      #     Required. The `Service` to draw updates from.
       #     The given `name` specifies the resource to update.
       # @!attribute [rw] update_mask
       #   @return [Google::Protobuf::FieldMask]
@@ -94,14 +94,14 @@ module Google
       # The `DeleteService` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     Resource name of the `Service` to delete.
-      #     Of the form `projects/{project_id}/service/{service_id}`.
+      #     Required. Resource name of the `Service` to delete.
+      #     Of the form `projects/{project_id}/services/{service_id}`.
       class DeleteServiceRequest; end
 
       # The `CreateServiceLevelObjective` request.
       # @!attribute [rw] parent
       #   @return [String]
-      #     Resource name of the parent `Service`.
+      #     Required. Resource name of the parent `Service`.
       #     Of the form `projects/{project_id}/services/{service_id}`.
       # @!attribute [rw] service_level_objective_id
       #   @return [String]
@@ -110,7 +110,7 @@ module Google
       #     match the pattern [a-z0-9\-]+
       # @!attribute [rw] service_level_objective
       #   @return [Google::Monitoring::V3::ServiceLevelObjective]
-      #     The `ServiceLevelObjective` to create.
+      #     Required. The `ServiceLevelObjective` to create.
       #     The provided `name` will be respected if no `ServiceLevelObjective` exists
       #     with this name.
       class CreateServiceLevelObjectiveRequest; end
@@ -118,7 +118,7 @@ module Google
       # The `GetServiceLevelObjective` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     Resource name of the `ServiceLevelObjective` to get.
+      #     Required. Resource name of the `ServiceLevelObjective` to get.
       #     Of the form
       #     `projects/{project_id}/services/{service_id}/serviceLevelObjectives/{slo_name}`.
       # @!attribute [rw] view
@@ -132,7 +132,7 @@ module Google
       # The `ListServiceLevelObjectives` request.
       # @!attribute [rw] parent
       #   @return [String]
-      #     Resource name of the parent `Service`.
+      #     Required. Resource name of the parent `Service`.
       #     Of the form `projects/{project_id}/services/{service_id}`.
       # @!attribute [rw] filter
       #   @return [String]
@@ -168,7 +168,7 @@ module Google
       # The `UpdateServiceLevelObjective` request.
       # @!attribute [rw] service_level_objective
       #   @return [Google::Monitoring::V3::ServiceLevelObjective]
-      #     The `ServiceLevelObjective` to draw updates from.
+      #     Required. The `ServiceLevelObjective` to draw updates from.
       #     The given `name` specifies the resource to update.
       # @!attribute [rw] update_mask
       #   @return [Google::Protobuf::FieldMask]
@@ -178,7 +178,7 @@ module Google
       # The `DeleteServiceLevelObjective` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     Resource name of the `ServiceLevelObjective` to delete.
+      #     Required. Resource name of the `ServiceLevelObjective` to delete.
       #     Of the form
       #     `projects/{project_id}/services/{service_id}/serviceLevelObjectives/{slo_name}`.
       class DeleteServiceLevelObjectiveRequest; end

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

@@ -19,7 +19,7 @@ module Google
       # The protocol for the `ListUptimeCheckConfigs` request.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The project whose Uptime check configurations are listed. The format
+      #     Required. The project whose Uptime check configurations are listed. The format
       #       is `projects/[PROJECT_ID]`.
       # @!attribute [rw] page_size
       #   @return [Integer]
@@ -54,18 +54,18 @@ module Google
       # The protocol for the `GetUptimeCheckConfig` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The Uptime check configuration to retrieve. The format
+      #     Required. The Uptime check configuration to retrieve. The format
       #       is `projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]`.
       class GetUptimeCheckConfigRequest; end
 
       # The protocol for the `CreateUptimeCheckConfig` request.
       # @!attribute [rw] parent
       #   @return [String]
-      #     The project in which to create the Uptime check. The format
+      #     Required. The project in which to create the Uptime check. The format
       #       is `projects/[PROJECT_ID]`.
       # @!attribute [rw] uptime_check_config
       #   @return [Google::Monitoring::V3::UptimeCheckConfig]
-      #     The new Uptime check configuration.
+      #     Required. The new Uptime check configuration.
       class CreateUptimeCheckConfigRequest; end
 
       # The protocol for the `UpdateUptimeCheckConfig` request.
@@ -93,7 +93,7 @@ module Google
       # The protocol for the `DeleteUptimeCheckConfig` request.
       # @!attribute [rw] name
       #   @return [String]
-      #     The Uptime check configuration to delete. The format
+      #     Required. The Uptime check configuration to delete. The format
       #       is `projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]`.
       class DeleteUptimeCheckConfigRequest; end
 

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

@@ -282,7 +282,7 @@ module Google
           # Lists the existing groups.
           #
           # @param name [String]
-          #   The project whose groups are to be listed. The format is
+          #   Required. The project whose groups are to be listed. The format is
           #   `"projects/{project_id_or_number}"`.
           # @param children_of_group [String]
           #   A group name: `"projects/{project_id_or_number}/groups/{group_id}"`.
@@ -358,7 +358,7 @@ module Google
           # Gets a single group.
           #
           # @param name [String]
-          #   The group to retrieve. The format is
+          #   Required. The group to retrieve. The format is
           #   `"projects/{project_id_or_number}/groups/{group_id}"`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -389,10 +389,10 @@ module Google
           # Creates a new group.
           #
           # @param name [String]
-          #   The project in which to create the group. The format is
+          #   Required. The project in which to create the group. The format is
           #   `"projects/{project_id_or_number}"`.
           # @param group [Google::Monitoring::V3::Group | Hash]
-          #   A group definition. It is an error to define the `name` field because
+          #   Required. A group definition. It is an error to define the `name` field because
           #   the system assigns the name.
           #   A hash of the same form as `Google::Monitoring::V3::Group`
           #   can also be provided.
@@ -435,7 +435,7 @@ module Google
           # You can change any group attributes except `name`.
           #
           # @param group [Google::Monitoring::V3::Group | Hash]
-          #   The new definition of the group.  All fields of the existing group,
+          #   Required. The new definition of the group.  All fields of the existing group,
           #   excepting `name`, are replaced with the corresponding fields of this group.
           #   A hash of the same form as `Google::Monitoring::V3::Group`
           #   can also be provided.
@@ -474,7 +474,7 @@ module Google
           # Deletes an existing group.
           #
           # @param name [String]
-          #   The group to delete. The format is
+          #   Required. The group to delete. The format is
           #   `"projects/{project_id_or_number}/groups/{group_id}"`.
           # @param recursive [true, false]
           #   If this field is true, then the request means to delete a group with all
@@ -511,7 +511,7 @@ module Google
           # Lists the monitored resources that are members of a group.
           #
           # @param name [String]
-          #   The group whose members are listed. The format is
+          #   Required. The group whose members are listed. The format is
           #   `"projects/{project_id_or_number}/groups/{group_id}"`.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API