google-cloud-monitoring-v3 0.1.0

data/proto_docs/google/monitoring/v3/metric_service.rb

@@ -0,0 +1,366 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Monitoring
+      module V3
+        # The `ListMonitoredResourceDescriptors` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. 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
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        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 `page_token` in the next call to this method.
+        class ListMonitoredResourceDescriptorsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The `GetMonitoredResourceDescriptor` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     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`.
+        class GetMonitoredResourceDescriptorRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The `ListMetricDescriptors` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. 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
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        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 `page_token` in the next call to this method.
+        class ListMetricDescriptorsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The `GetMetricDescriptor` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     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"`.
+        class GetMetricDescriptorRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The `CreateMetricDescriptor` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     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]
+        #     Required. The new [custom metric](https://cloud.google.com/monitoring/custom-metrics)
+        #     descriptor.
+        class CreateMetricDescriptorRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The `DeleteMetricDescriptor` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     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"`.
+        class DeleteMetricDescriptorRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The `ListTimeSeries` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The project on which to execute the request. The format is:
+        #
+        #         projects/[PROJECT_ID_OR_NUMBER]
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     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:
+        #
+        #         metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
+        #             metric.labels.instance_name = "my-instance-name"
+        # @!attribute [rw] interval
+        #   @return [::Google::Cloud::Monitoring::V3::TimeInterval]
+        #     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
+        #   @return [::Google::Cloud::Monitoring::V3::Aggregation]
+        #     Specifies the alignment of data points in individual time series as
+        #     well as how to combine the retrieved time series across specified labels.
+        #
+        #     By default (if no `aggregation` is explicitly specified), the raw time
+        #     series data is returned.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Unsupported: must be left blank. The points in each time series are
+        #     currently returned in reverse time order (most recent to oldest).
+        # @!attribute [rw] view
+        #   @return [::Google::Cloud::Monitoring::V3::ListTimeSeriesRequest::TimeSeriesView]
+        #     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
+        #     `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
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # 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::Cloud::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 `page_token` 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
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The `CreateTimeSeries` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The project on which to execute the request. The format is:
+        #
+        #         projects/[PROJECT_ID_OR_NUMBER]
+        # @!attribute [rw] time_series
+        #   @return [::Array<::Google::Cloud::Monitoring::V3::TimeSeries>]
+        #     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
+        #     all label values for the metric and the monitored resource.
+        #
+        #     The maximum number of `TimeSeries` objects per `Create` request is 200.
+        class CreateTimeSeriesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # DEPRECATED. Used to hold per-time-series error status.
+        # @!attribute [rw] time_series
+        #   @return [::Google::Cloud::Monitoring::V3::TimeSeries]
+        #     DEPRECATED. Time series ID that resulted in the `status` error.
+        # @!attribute [rw] status
+        #   @return [::Google::Rpc::Status]
+        #     DEPRECATED. The status of the requested write operation for `time_series`.
+        class CreateTimeSeriesError
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Summary of the result of a failed request to write data to a time series.
+        # @!attribute [rw] total_point_count
+        #   @return [::Integer]
+        #     The number of points in the request.
+        # @!attribute [rw] success_point_count
+        #   @return [::Integer]
+        #     The number of points that were successfully written.
+        # @!attribute [rw] errors
+        #   @return [::Array<::Google::Cloud::Monitoring::V3::CreateTimeSeriesSummary::Error>]
+        #     The number of points that failed to be written. Order is not guaranteed.
+        class CreateTimeSeriesSummary
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Detailed information about an error category.
+          # @!attribute [rw] status
+          #   @return [::Google::Rpc::Status]
+          #     The status of the requested write operation.
+          # @!attribute [rw] point_count
+          #   @return [::Integer]
+          #     The number of points that couldn't be written because of `status`.
+          class Error
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # The `QueryTimeSeries` request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The project on which to execute the request. The format is:
+        #
+        #         projects/[PROJECT_ID_OR_NUMBER]
+        # @!attribute [rw] query
+        #   @return [::String]
+        #     Required. The query in the monitoring query language format. The default
+        #     time zone is in UTC.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     A positive number that is the maximum number of time_series_data 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 QueryTimeSeriesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The `QueryTimeSeries` response.
+        # @!attribute [rw] time_series_descriptor
+        #   @return [::Google::Cloud::Monitoring::V3::TimeSeriesDescriptor]
+        #     The descriptor for the time series data.
+        # @!attribute [rw] time_series_data
+        #   @return [::Array<::Google::Cloud::Monitoring::V3::TimeSeriesData>]
+        #     The time series data.
+        # @!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
+        #     `page_token` in the next call to this method.
+        # @!attribute [rw] partial_errors
+        #   @return [::Array<::Google::Rpc::Status>]
+        #     Query execution errors that may have caused the time series data returned
+        #     to be incomplete. The available data will be available in the
+        #     response.
+        class QueryTimeSeriesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # This is an error detail intended to be used with INVALID_ARGUMENT errors.
+        # @!attribute [rw] errors
+        #   @return [::Array<::Google::Cloud::Monitoring::V3::QueryError>]
+        #     Errors in parsing the time series query language text. The number of errors
+        #     in the response may be limited.
+        # @!attribute [rw] error_summary
+        #   @return [::String]
+        #     A summary of all the errors.
+        class QueryErrorList
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/monitoring/v3/mutation_record.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Monitoring
+      module V3
+        # Describes a change made to a configuration.
+        # @!attribute [rw] mutate_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     When the change occurred.
+        # @!attribute [rw] mutated_by
+        #   @return [::String]
+        #     The email address of the user making the change.
+        class MutationRecord
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/monitoring/v3/notification.rb

@@ -0,0 +1,186 @@
+# frozen_string_literal: true
+
+# Copyright 2020 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Monitoring
+      module V3
+        # A description of a notification channel. The descriptor includes
+        # the properties of the channel and the set of labels or fields that
+        # must be specified to configure channels of a given type.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The full REST resource name for this descriptor. The format is:
+        #
+        #         projects/[PROJECT_ID_OR_NUMBER]/notificationChannelDescriptors/[TYPE]
+        #
+        #     In the above, `[TYPE]` is the value of the `type` field.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     The type of notification channel, such as "email", "sms", etc.
+        #     Notification channel types are globally unique.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     A human-readable name for the notification channel type.  This
+        #     form of the name is suitable for a user interface.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     A human-readable description of the notification channel
+        #     type. The description may include a description of the properties
+        #     of the channel and pointers to external documentation.
+        # @!attribute [rw] labels
+        #   @return [::Array<::Google::Api::LabelDescriptor>]
+        #     The set of labels that must be defined to identify a particular
+        #     channel of the corresponding type. Each label includes a
+        #     description for how that field should be populated.
+        # @!attribute [rw] supported_tiers
+        #   @return [::Array<::Google::Cloud::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
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A `NotificationChannel` is a medium through which an alert is
+        # delivered when a policy violation is detected. Examples of channels
+        # include email, SMS, and third-party messaging applications. Fields
+        # containing sensitive information like authentication tokens or
+        # contact info are only partially populated on retrieval.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     The type of the notification channel. This field matches the
+        #     value of the {::Google::Cloud::Monitoring::V3::NotificationChannelDescriptor#type NotificationChannelDescriptor.type} field.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The full REST resource name for this channel. The format is:
+        #
+        #         projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
+        #
+        #     The `[CHANNEL_ID]` is automatically assigned by the server on creation.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     An optional human-readable name for this notification channel. It is
+        #     recommended that you specify a non-empty and unique name in order to
+        #     make it easier to identify the channels in your project, though this is
+        #     not enforced. The display name is limited to 512 Unicode characters.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     An optional human-readable description of this notification channel. This
+        #     description may provide additional details, beyond the display
+        #     name, for the channel. This may not exceed 1024 Unicode characters.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Configuration fields that define the channel and its behavior. The
+        #     permissible and required labels are specified in the
+        #     {::Google::Cloud::Monitoring::V3::NotificationChannelDescriptor#labels NotificationChannelDescriptor.labels} of the
+        #     `NotificationChannelDescriptor` corresponding to the `type` field.
+        # @!attribute [rw] user_labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     User-supplied key/value data that does not need to conform to
+        #     the corresponding `NotificationChannelDescriptor`'s schema, unlike
+        #     the `labels` field. This field is intended to be used for organizing
+        #     and identifying the `NotificationChannel` objects.
+        #
+        #     The field can contain up to 64 entries. Each key and value is limited to
+        #     63 Unicode characters or 128 bytes, whichever is smaller. Labels and
+        #     values can contain only lowercase letters, numerals, underscores, and
+        #     dashes. Keys must begin with a letter.
+        # @!attribute [rw] verification_status
+        #   @return [::Google::Cloud::Monitoring::V3::NotificationChannel::VerificationStatus]
+        #     Indicates whether this channel has been verified or not. On a
+        #     {::Google::Cloud::Monitoring::V3::NotificationChannelService::Client#list_notification_channels `ListNotificationChannels`}
+        #     or
+        #     {::Google::Cloud::Monitoring::V3::NotificationChannelService::Client#get_notification_channel `GetNotificationChannel`}
+        #     operation, this field is expected to be populated.
+        #
+        #     If the value is `UNVERIFIED`, then it indicates that the channel is
+        #     non-functioning (it both requires verification and lacks verification);
+        #     otherwise, it is assumed that the channel works.
+        #
+        #     If the channel is neither `VERIFIED` nor `UNVERIFIED`, it implies that
+        #     the channel is of a type that does not require verification or that
+        #     this specific channel has been exempted from verification because it was
+        #     created prior to verification being required for channels of this type.
+        #
+        #     This field cannot be modified using a standard
+        #     {::Google::Cloud::Monitoring::V3::NotificationChannelService::Client#update_notification_channel `UpdateNotificationChannel`}
+        #     operation. To change the value of this field, you must call
+        #     {::Google::Cloud::Monitoring::V3::NotificationChannelService::Client#verify_notification_channel `VerifyNotificationChannel`}.
+        # @!attribute [rw] enabled
+        #   @return [::Google::Protobuf::BoolValue]
+        #     Whether notifications are forwarded to the described channel. This makes
+        #     it possible to disable delivery of notifications to a particular channel
+        #     without removing the channel from all alerting policies that reference
+        #     the channel. This is a more convenient approach when the change is
+        #     temporary and you want to receive notifications from the same set
+        #     of alerting policies on the channel at some point in the future.
+        class NotificationChannel
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class UserLabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Indicates whether the channel has been verified or not. It is illegal
+          # to specify this field in a
+          # {::Google::Cloud::Monitoring::V3::NotificationChannelService::Client#create_notification_channel `CreateNotificationChannel`}
+          # or an
+          # {::Google::Cloud::Monitoring::V3::NotificationChannelService::Client#update_notification_channel `UpdateNotificationChannel`}
+          # operation.
+          module VerificationStatus
+            # Sentinel value used to indicate that the state is unknown, omitted, or
+            # is not applicable (as in the case of channels that neither support
+            # nor require verification in order to function).
+            VERIFICATION_STATUS_UNSPECIFIED = 0
+
+            # The channel has yet to be verified and requires verification to function.
+            # Note that this state also applies to the case where the verification
+            # process has been initiated by sending a verification code but where
+            # the verification code has not been submitted to complete the process.
+            UNVERIFIED = 1
+
+            # It has been proven that notifications can be received on this
+            # notification channel and that someone on the project has access
+            # to messages that are delivered to that channel.
+            VERIFIED = 2
+          end
+        end
+      end
+    end
+  end
+end