google-cloud-monitoring 0.28.0 → 0.29.0

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

@@ -0,0 +1,145 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Google
+  module Monitoring
+    module V3
+      # The +ListGroup+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The project whose groups are to be listed. The format is
+      #     +"projects/{project_id_or_number}"+.
+      # @!attribute [rw] children_of_group
+      #   @return [String]
+      #     A group name: +"projects/{project_id_or_number}/groups/{group_id}"+.
+      #     Returns groups whose +parentName+ field contains the group
+      #     name.  If no groups have this parent, the results are empty.
+      # @!attribute [rw] ancestors_of_group
+      #   @return [String]
+      #     A group name: +"projects/{project_id_or_number}/groups/{group_id}"+.
+      #     Returns groups that are ancestors of the specified group.
+      #     The groups are returned in order, starting with the immediate parent and
+      #     ending with the most distant ancestor.  If the specified group has no
+      #     immediate parent, the results are empty.
+      # @!attribute [rw] descendants_of_group
+      #   @return [String]
+      #     A group name: +"projects/{project_id_or_number}/groups/{group_id}"+.
+      #     Returns the descendants of the specified group.  This is a superset of
+      #     the results returned by the +childrenOfGroup+ filter, and includes
+      #     children-of-children, and so forth.
+      # @!attribute [rw] page_size
+      #   @return [Integer]
+      #     A positive number that is the maximum number of results to return.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     If this field is not empty then it must contain the +nextPageToken+ value
+      #     returned by a previous call to this method.  Using this field causes the
+      #     method to return additional results from the previous method call.
+      class ListGroupsRequest; end
+
+      # The +ListGroups+ response.
+      # @!attribute [rw] group
+      #   @return [Array<Google::Monitoring::V3::Group>]
+      #     The groups that match the specified filters.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     If there are more results than have been returned, then this field is set
+      #     to a non-empty value.  To see the additional results,
+      #     use that value as +pageToken+ in the next call to this method.
+      class ListGroupsResponse; end
+
+      # The +GetGroup+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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
+      #     +"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
+      #     the system assigns the name.
+      # @!attribute [rw] validate_only
+      #   @return [true, false]
+      #     If true, validate this request but do not create the group.
+      class CreateGroupRequest; end
+
+      # The +UpdateGroup+ request.
+      # @!attribute [rw] group
+      #   @return [Google::Monitoring::V3::Group]
+      #     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]
+      #     If true, validate this request but do not update the existing group.
+      class UpdateGroupRequest; end
+
+      # The +DeleteGroup+ request. You can only delete a group if it has no children.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The group to delete. The format is
+      #     +"projects/{project_id_or_number}/groups/{group_id}"+.
+      class DeleteGroupRequest; end
+
+      # The +ListGroupMembers+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The group whose members are listed. The format is
+      #     +"projects/{project_id_or_number}/groups/{group_id}"+.
+      # @!attribute [rw] page_size
+      #   @return [Integer]
+      #     A positive number that is the maximum number of results to return.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     If this field is not empty then it must contain the +nextPageToken+ value
+      #     returned by a previous call to this method.  Using this field causes the
+      #     method to return additional results from the previous method call.
+      # @!attribute [rw] filter
+      #   @return [String]
+      #     An optional [list filter](https://cloud.google.com/monitoring/api/learn_more#filtering) describing
+      #     the members to be returned.  The filter may reference the type, labels, and
+      #     metadata of monitored resources that comprise the group.
+      #     For example, to return only resources representing Compute Engine VM
+      #     instances, use this filter:
+      #
+      #         resource.type = "gce_instance"
+      # @!attribute [rw] interval
+      #   @return [Google::Monitoring::V3::TimeInterval]
+      #     An optional time interval for which results should be returned. Only
+      #     members that were part of the group during the specified interval are
+      #     included in the response.  If no interval is provided then the group
+      #     membership over the last minute is returned.
+      class ListGroupMembersRequest; end
+
+      # The +ListGroupMembers+ response.
+      # @!attribute [rw] members
+      #   @return [Array<Google::Api::MonitoredResource>]
+      #     A set of monitored resources in the group.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     If there are more results than have been returned, then this field is
+      #     set to a non-empty value.  To see the additional results, use that value as
+      #     +pageToken+ in the next call to this method.
+      # @!attribute [rw] total_size
+      #   @return [Integer]
+      #     The total number of elements matching this request.
+      class ListGroupMembersResponse; end
+    end
+  end
+end

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

@@ -18,14 +18,14 @@ module Google
       # A single data point in a time series.
       # @!attribute [rw] interval
       #   @return [Google::Monitoring::V3::TimeInterval]
-      #     The time interval to which the data point applies.  For GAUGE metrics, only
-      #     the end time of the interval is used.  For DELTA metrics, the start and end
-      #     time should specify a non-zero interval, with subsequent points specifying
-      #     contiguous and non-overlapping intervals.  For CUMULATIVE metrics, the
-      #     start and end time should specify a non-zero interval, with subsequent
-      #     points specifying the same start time and increasing end times, until an
-      #     event resets the cumulative value to zero and sets a new start time for the
-      #     following points.
+      #     The time interval to which the data point applies.  For +GAUGE+ metrics,
+      #     only the end time of the interval is used.  For +DELTA+ metrics, the start
+      #     and end time should specify a non-zero interval, with subsequent points
+      #     specifying contiguous and non-overlapping intervals.  For +CUMULATIVE+
+      #     metrics, the start and end time should specify a non-zero interval, with
+      #     subsequent points specifying the same start time and increasing end times,
+      #     until an event resets the cumulative value to zero and sets a new start
+      #     time for the following points.
       # @!attribute [rw] value
       #   @return [Google::Monitoring::V3::TypedValue]
       #     The value of the data point.
@@ -41,8 +41,13 @@ module Google
       #     series.
       # @!attribute [rw] resource
       #   @return [Google::Api::MonitoredResource]
-      #     The associated resource. A fully-specified monitored resource used to
-      #     identify the time series.
+      #     The associated monitored resource.  Custom metrics can use only certain
+      #     monitored resource types in their time series data.
+      # @!attribute [rw] metadata
+      #   @return [Google::Api::MonitoredResourceMetadata]
+      #     Output only. The associated monitored resource metadata. When reading a
+      #     a timeseries, this field will include metadata labels that are explicitly
+      #     named in the reduction. When creating a timeseries, this field is ignored.
       # @!attribute [rw] metric_kind
       #   @return [Google::Api::MetricDescriptor::MetricKind]
       #     The metric kind of the time series. When listing time series, this metric
@@ -64,8 +69,8 @@ module Google
       #     the same as the type of the data in the +points+ field.
       # @!attribute [rw] points
       #   @return [Array<Google::Monitoring::V3::Point>]
-      #     The data points of this time series. When listing time series, the order of
-      #     the points is specified by the list method.
+      #     The data points of this time series. When listing time series, points are
+      #     returned in reverse time order.
       #
       #     When creating a time series, this field must contain exactly one point and
       #     the point's type must be the same as the value type of the associated

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

@@ -0,0 +1,227 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Google
+  module Monitoring
+    module V3
+      # The +ListMonitoredResourceDescriptors+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The project on which to execute the request. The format is
+      #     +"projects/{project_id_or_number}"+.
+      # @!attribute [rw] filter
+      #   @return [String]
+      #     An optional [filter](https://cloud.google.com/monitoring/api/v3/filters) describing
+      #     the descriptors to be returned.  The filter can reference
+      #     the descriptor's type and labels. For example, the
+      #     following filter returns only Google Compute Engine descriptors
+      #     that have an +id+ label:
+      #
+      #         resource.type = starts_with("gce_") AND resource.label:id
+      # @!attribute [rw] page_size
+      #   @return [Integer]
+      #     A positive number that is the maximum number of results to return.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     If this field is not empty then it must contain the +nextPageToken+ value
+      #     returned by a previous call to this method.  Using this field causes the
+      #     method to return additional results from the previous method call.
+      class ListMonitoredResourceDescriptorsRequest; end
+
+      # The +ListMonitoredResourceDescriptors+ response.
+      # @!attribute [rw] resource_descriptors
+      #   @return [Array<Google::Api::MonitoredResourceDescriptor>]
+      #     The monitored resource descriptors that are available to this project
+      #     and that match +filter+, if present.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     If there are more results than have been returned, then this field is set
+      #     to a non-empty value.  To see the additional results,
+      #     use that value as +pageToken+ in the next call to this method.
+      class ListMonitoredResourceDescriptorsResponse; end
+
+      # The +GetMonitoredResourceDescriptor+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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+.
+      class GetMonitoredResourceDescriptorRequest; end
+
+      # The +ListMetricDescriptors+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The project on which to execute the request. The format is
+      #     +"projects/{project_id_or_number}"+.
+      # @!attribute [rw] filter
+      #   @return [String]
+      #     If this field is empty, all custom and
+      #     system-defined metric descriptors are returned.
+      #     Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters)
+      #     specifies which metric descriptors are to be
+      #     returned. For example, the following filter matches all
+      #     [custom metrics](https://cloud.google.com/monitoring/custom-metrics):
+      #
+      #         metric.type = starts_with("custom.googleapis.com/")
+      # @!attribute [rw] page_size
+      #   @return [Integer]
+      #     A positive number that is the maximum number of results to return.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     If this field is not empty then it must contain the +nextPageToken+ value
+      #     returned by a previous call to this method.  Using this field causes the
+      #     method to return additional results from the previous method call.
+      class ListMetricDescriptorsRequest; end
+
+      # The +ListMetricDescriptors+ response.
+      # @!attribute [rw] metric_descriptors
+      #   @return [Array<Google::Api::MetricDescriptor>]
+      #     The metric descriptors that are available to the project
+      #     and that match the value of +filter+, if present.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     If there are more results than have been returned, then this field is set
+      #     to a non-empty value.  To see the additional results,
+      #     use that value as +pageToken+ in the next call to this method.
+      class ListMetricDescriptorsResponse; end
+
+      # The +GetMetricDescriptor+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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"+.
+      class GetMetricDescriptorRequest; end
+
+      # The +CreateMetricDescriptor+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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)
+      #     descriptor.
+      class CreateMetricDescriptorRequest; end
+
+      # The +DeleteMetricDescriptor+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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"+.
+      class DeleteMetricDescriptorRequest; end
+
+      # The +ListTimeSeries+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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
+      #     series should be returned.  The filter must specify a single metric type,
+      #     and can additionally specify metric labels and other information. For
+      #     example:
+      #
+      #         metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
+      #             metric.label.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
+      #     that contain data points in the specified interval are included
+      #     in the response.
+      # @!attribute [rw] aggregation
+      #   @return [Google::Monitoring::V3::Aggregation]
+      #     By default, the raw time series data is returned.
+      #     Use this field to combine multiple time series for different
+      #     views of the data.
+      # @!attribute [rw] order_by
+      #   @return [String]
+      #     Unsupported: must be left blank. The points in each time series are
+      #     returned in reverse time order.
+      # @!attribute [rw] view
+      #   @return [Google::Monitoring::V3::ListTimeSeriesRequest::TimeSeriesView]
+      #     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
+      #     +page_size+ is empty or more than 100,000 results, the effective
+      #     +page_size+ is 100,000 results. If +view+ is set to +FULL+, this is the
+      #     maximum number of +Points+ returned. If +view+ is set to +HEADERS+, this is
+      #     the maximum number of +TimeSeries+ returned.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     If this field is not empty then it must contain the +nextPageToken+ value
+      #     returned by a previous call to this method.  Using this field causes the
+      #     method to return additional results from the previous method call.
+      class ListTimeSeriesRequest
+        # Controls which fields are returned by +ListTimeSeries+.
+        module TimeSeriesView
+          # Returns the identity of the metric(s), the time series,
+          # and the time series data.
+          FULL = 0
+
+          # Returns the identity of the metric and the time series resource,
+          # but not the time series data.
+          HEADERS = 1
+        end
+      end
+
+      # The +ListTimeSeries+ response.
+      # @!attribute [rw] time_series
+      #   @return [Array<Google::Monitoring::V3::TimeSeries>]
+      #     One or more time series that match the filter included in the request.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     If there are more results than have been returned, then this field is set
+      #     to a non-empty value.  To see the additional results,
+      #     use that value as +pageToken+ in the next call to this method.
+      # @!attribute [rw] execution_errors
+      #   @return [Array<Google::Rpc::Status>]
+      #     Query execution errors that may have caused the time series data returned
+      #     to be incomplete.
+      class ListTimeSeriesResponse; end
+
+      # The +CreateTimeSeries+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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.
+      #     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
+      #     all label values for the metric and the monitored resource.
+      class CreateTimeSeriesRequest; end
+
+      # Describes the result of a failed request to write data to a time series.
+      # @!attribute [rw] time_series
+      #   @return [Google::Monitoring::V3::TimeSeries]
+      #     The time series, including the +Metric+, +MonitoredResource+,
+      #     and +Point+s (including timestamp and value) that resulted
+      #     in the error. This field provides all of the context that
+      #     would be needed to retry the operation.
+      # @!attribute [rw] status
+      #   @return [Google::Rpc::Status]
+      #     The status of the requested write operation.
+      class CreateTimeSeriesError; end
+    end
+  end
+end

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

@@ -0,0 +1,213 @@
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Google
+  module Monitoring
+    module V3
+      # The +ListNotificationChannelDescriptors+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The REST resource name of the parent from which to retrieve
+      #     the notification channel descriptors. The expected syntax is:
+      #
+      #         projects/[PROJECT_ID]
+      #
+      #     Note that this names the parent container in which to look for the
+      #     descriptors; to retrieve a single descriptor by name, use the
+      #     {Google::Monitoring::V3::NotificationChannelService::GetNotificationChannelDescriptor GetNotificationChannelDescriptor}
+      #     operation, instead.
+      # @!attribute [rw] page_size
+      #   @return [Integer]
+      #     The maximum number of results to return in a single response. If
+      #     not set to a positive number, a reasonable value will be chosen by the
+      #     service.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     If non-empty, +page_token+ must contain a value returned as the
+      #     +next_page_token+ in a previous response to request the next set
+      #     of results.
+      class ListNotificationChannelDescriptorsRequest; end
+
+      # The +ListNotificationChannelDescriptors+ response.
+      # @!attribute [rw] channel_descriptors
+      #   @return [Array<Google::Monitoring::V3::NotificationChannelDescriptor>]
+      #     The monitored resource descriptors supported for the specified
+      #     project, optionally filtered.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     If not empty, indicates that there may be more results that match
+      #     the request. Use the value in the +page_token+ field in a
+      #     subsequent request to fetch the next set of results. If empty,
+      #     all results have been returned.
+      class ListNotificationChannelDescriptorsResponse; end
+
+      # The +GetNotificationChannelDescriptor+ response.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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:
+      #
+      #         projects/[PROJECT_ID]
+      #
+      #     Note that this names the container into which the channel will be
+      #     written. This does not name the newly created channel. The resulting
+      #     channel's name will have a normalized version of this field as a prefix,
+      #     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.
+      class CreateNotificationChannelRequest; end
+
+      # The +ListNotificationChannels+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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
+      #     the
+      #     {Google::Monitoring::V3::NotificationChannelService::GetNotificationChannel +GetNotificationChannel+} operation.
+      # @!attribute [rw] filter
+      #   @return [String]
+      #     If provided, this field specifies the criteria that must be met by
+      #     notification channels to be included in the response.
+      #
+      #     For more details, see [sorting and
+      #     filtering](/monitoring/api/v3/sorting-and-filtering).
+      # @!attribute [rw] order_by
+      #   @return [String]
+      #     A comma-separated list of fields by which to sort the result. Supports
+      #     the same set of fields as in +filter+. Entries can be prefixed with
+      #     a minus sign to sort in descending rather than ascending order.
+      #
+      #     For more details, see [sorting and
+      #     filtering](/monitoring/api/v3/sorting-and-filtering).
+      # @!attribute [rw] page_size
+      #   @return [Integer]
+      #     The maximum number of results to return in a single response. If
+      #     not set to a positive number, a reasonable value will be chosen by the
+      #     service.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     If non-empty, +page_token+ must contain a value returned as the
+      #     +next_page_token+ in a previous response to request the next set
+      #     of results.
+      class ListNotificationChannelsRequest; end
+
+      # The +ListNotificationChannels+ response.
+      # @!attribute [rw] notification_channels
+      #   @return [Array<Google::Monitoring::V3::NotificationChannel>]
+      #     The notification channels defined for the specified project.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     If not empty, indicates that there may be more results that match
+      #     the request. Use the value in the +page_token+ field in a
+      #     subsequent request to fetch the next set of results. If empty,
+      #     all results have been returned.
+      class ListNotificationChannelsResponse; end
+
+      # The +GetNotificationChannel+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The channel for which to execute the request. The format is
+      #     +projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]+.
+      class GetNotificationChannelRequest; end
+
+      # The +UpdateNotificationChannel+ request.
+      # @!attribute [rw] update_mask
+      #   @return [Google::Protobuf::FieldMask]
+      #     The fields to update.
+      # @!attribute [rw] notification_channel
+      #   @return [Google::Monitoring::V3::NotificationChannel]
+      #     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+.
+      class UpdateNotificationChannelRequest; end
+
+      # The +DeleteNotificationChannel+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The channel for which to execute the request. The format is
+      #     +projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]+.
+      # @!attribute [rw] force
+      #   @return [true, false]
+      #     If true, the notification channel will be deleted regardless of its
+      #     use in alert policies (the policies will be updated to remove the
+      #     channel). If false, channels that are still referenced by an existing
+      #     alerting policy will fail to be deleted in a delete operation.
+      class DeleteNotificationChannelRequest; end
+
+      # The +SendNotificationChannelVerificationCode+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     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
+      #     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
+      #   @return [Google::Protobuf::Timestamp]
+      #     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).
+      class GetNotificationChannelVerificationCodeRequest; end
+
+      # The +GetNotificationChannelVerificationCode+ request.
+      # @!attribute [rw] code
+      #   @return [String]
+      #     The verification code, which may be used to verify other channels
+      #     that have an equivalent identity (i.e. other channels of the same
+      #     type with the same fingerprint such as other email channels with
+      #     the same email address or other sms channels with the same number).
+      # @!attribute [rw] expire_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     The expiration time associated with the code that was returned. If
+      #     an expiration was provided in the request, this is the minimum of the
+      #     requested expiration in the request and the max permitted expiration.
+      class GetNotificationChannelVerificationCodeResponse; end
+
+      # The +VerifyNotificationChannel+ request.
+      # @!attribute [rw] name
+      #   @return [String]
+      #     The notification channel to verify.
+      # @!attribute [rw] code
+      #   @return [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).
+      class VerifyNotificationChannelRequest; end
+    end
+  end
+end