google-api-client 0.25.0 → 0.26.0

data/generated/google/apis/monitoring_v3.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/monitoring/api/
     module MonitoringV3
       VERSION = 'V3'
-      REVISION = '20181027'
+      REVISION = '20181205'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/monitoring_v3/classes.rb

@@ -646,7 +646,8 @@ module Google
         # 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.
+        # monitored resource.The maximum number of TimeSeries objects per Create request
+        # is 200.
         # Corresponds to the JSON property `timeSeries`
         # @return [Array<Google::Apis::MonitoringV3::TimeSeries>]
         attr_accessor :time_series
@@ -1237,6 +1238,11 @@ module Google
         # @return [String]
         attr_accessor :peer_project_id
       
+        # The current operational state of the internal checker.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1248,6 +1254,7 @@ module Google
           @name = args[:name] if args.key?(:name)
           @network = args[:network] if args.key?(:network)
           @peer_project_id = args[:peer_project_id] if args.key?(:peer_project_id)
+          @state = args[:state] if args.key?(:state)
         end
       end
       
@@ -2321,9 +2328,12 @@ module Google
       class Point
         include Google::Apis::Core::Hashable
       
-        # A time interval extending just after a start time through an end time. If the
-        # start time is the same as the end time, then the interval represents a single
-        # point in time.
+        # A time interval extending just after a start time through an end time. The
+        # start time must not be later than the end time. The default start time is the
+        # end time, making the startTime value technically optional. Whether this is
+        # useful depends on the MetricKind. If the start and end times are the same, the
+        # interval represents a point in time. This is appropriate for GAUGE metrics,
+        # but not for DELTA and CUMULATIVE metrics, which cover a span of time.
         # Corresponds to the JSON property `interval`
         # @return [Google::Apis::MonitoringV3::TimeInterval]
         attr_accessor :interval
@@ -2543,9 +2553,12 @@ module Google
         end
       end
       
-      # A time interval extending just after a start time through an end time. If the
-      # start time is the same as the end time, then the interval represents a single
-      # point in time.
+      # A time interval extending just after a start time through an end time. The
+      # start time must not be later than the end time. The default start time is the
+      # end time, making the startTime value technically optional. Whether this is
+      # useful depends on the MetricKind. If the start and end times are the same, the
+      # interval represents a point in time. This is appropriate for GAUGE metrics,
+      # but not for DELTA and CUMULATIVE metrics, which cover a span of time.
       class TimeInterval
         include Google::Apis::Core::Hashable
       

data/generated/google/apis/monitoring_v3/representations.rb

@@ -686,6 +686,7 @@ module Google
           property :name, as: 'name'
           property :network, as: 'network'
           property :peer_project_id, as: 'peerProjectId'
+          property :state, as: 'state'
         end
       end
       

data/generated/google/apis/monitoring_v3/service.rb

@@ -49,231 +49,6 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Creates a new metric descriptor. User-created metric descriptors define custom
-        # metrics.
-        # @param [String] name
-        #   The project on which to execute the request. The format is "projects/`
-        #   project_id_or_number`".
-        # @param [Google::Apis::MonitoringV3::MetricDescriptor] metric_descriptor_object
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::MonitoringV3::MetricDescriptor] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::MonitoringV3::MetricDescriptor]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_metric_descriptor(name, metric_descriptor_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v3/{+name}/metricDescriptors', options)
-          command.request_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
-          command.request_object = metric_descriptor_object
-          command.response_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
-          command.response_class = Google::Apis::MonitoringV3::MetricDescriptor
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Deletes a metric descriptor. Only user-created custom metrics can be deleted.
-        # @param [String] name
-        #   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".
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::MonitoringV3::Empty]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_metric_descriptor(name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:delete, 'v3/{+name}', options)
-          command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
-          command.response_class = Google::Apis::MonitoringV3::Empty
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets a single metric descriptor. This method does not require a Stackdriver
-        # account.
-        # @param [String] name
-        #   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".
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::MonitoringV3::MetricDescriptor] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::MonitoringV3::MetricDescriptor]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_metric_descriptor(name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v3/{+name}', options)
-          command.response_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
-          command.response_class = Google::Apis::MonitoringV3::MetricDescriptor
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Lists metric descriptors that match a filter. This method does not require a
-        # Stackdriver account.
-        # @param [String] name
-        #   The project on which to execute the request. The format is "projects/`
-        #   project_id_or_number`".
-        # @param [String] filter
-        #   If this field is empty, all custom and system-defined metric descriptors are
-        #   returned. Otherwise, the filter specifies which metric descriptors are to be
-        #   returned. For example, the following filter matches all custom metrics:
-        #   metric.type = starts_with("custom.googleapis.com/")
-        # @param [Fixnum] page_size
-        #   A positive number that is the maximum number of results to return.
-        # @param [String] page_token
-        #   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.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::MonitoringV3::ListMetricDescriptorsResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::MonitoringV3::ListMetricDescriptorsResponse]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_metric_descriptors(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v3/{+name}/metricDescriptors', options)
-          command.response_representation = Google::Apis::MonitoringV3::ListMetricDescriptorsResponse::Representation
-          command.response_class = Google::Apis::MonitoringV3::ListMetricDescriptorsResponse
-          command.params['name'] = name unless name.nil?
-          command.query['filter'] = filter unless filter.nil?
-          command.query['pageSize'] = page_size unless page_size.nil?
-          command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets a single monitored resource descriptor. This method does not require a
-        # Stackdriver account.
-        # @param [String] name
-        #   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.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::MonitoringV3::MonitoredResourceDescriptor] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::MonitoringV3::MonitoredResourceDescriptor]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_monitored_resource_descriptor(name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v3/{+name}', options)
-          command.response_representation = Google::Apis::MonitoringV3::MonitoredResourceDescriptor::Representation
-          command.response_class = Google::Apis::MonitoringV3::MonitoredResourceDescriptor
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Lists monitored resource descriptors that match a filter. This method does not
-        # require a Stackdriver account.
-        # @param [String] name
-        #   The project on which to execute the request. The format is "projects/`
-        #   project_id_or_number`".
-        # @param [String] filter
-        #   An optional filter 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
-        # @param [Fixnum] page_size
-        #   A positive number that is the maximum number of results to return.
-        # @param [String] page_token
-        #   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.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_monitored_resource_descriptors(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v3/{+name}/monitoredResourceDescriptors', options)
-          command.response_representation = Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse::Representation
-          command.response_class = Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse
-          command.params['name'] = name unless name.nil?
-          command.query['filter'] = filter unless filter.nil?
-          command.query['pageSize'] = page_size unless page_size.nil?
-          command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Creates a new alerting policy.
         # @param [String] name
         #   The project in which to create the alerting policy. The format is projects/[
@@ -1720,146 +1495,6 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates or adds data to one or more time series. The response is empty if all
-        # time series in the request were written. If any time series could not be
-        # written, a corresponding failure message is included in the error response.
-        # @param [String] name
-        #   The project on which to execute the request. The format is "projects/`
-        #   project_id_or_number`".
-        # @param [Google::Apis::MonitoringV3::CreateTimeSeriesRequest] create_time_series_request_object
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::MonitoringV3::Empty]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_time_series(name, create_time_series_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v3/{+name}/timeSeries', options)
-          command.request_representation = Google::Apis::MonitoringV3::CreateTimeSeriesRequest::Representation
-          command.request_object = create_time_series_request_object
-          command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
-          command.response_class = Google::Apis::MonitoringV3::Empty
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Lists time series that match a filter. This method does not require a
-        # Stackdriver account.
-        # @param [String] name
-        #   The project on which to execute the request. The format is "projects/`
-        #   project_id_or_number`".
-        # @param [String] aggregation_alignment_period
-        #   The alignment period for per-time series alignment. If present,
-        #   alignmentPeriod must be at least 60 seconds. After per-time series alignment,
-        #   each time series will contain data points only on the period boundaries. If
-        #   perSeriesAligner is not specified or equals ALIGN_NONE, then this field is
-        #   ignored. If perSeriesAligner is specified and does not equal ALIGN_NONE, then
-        #   this field must be defined; otherwise an error is returned.
-        # @param [String] aggregation_cross_series_reducer
-        #   The approach to be used to combine time series. Not all reducer functions may
-        #   be applied to all time series, depending on the metric type and the value type
-        #   of the original time series. Reduction may change the metric type of value
-        #   type of the time series.Time series data must be aligned in order to perform
-        #   cross-time series reduction. If crossSeriesReducer is specified, then
-        #   perSeriesAligner must be specified and not equal ALIGN_NONE and
-        #   alignmentPeriod must be specified; otherwise, an error is returned.
-        # @param [Array<String>, String] aggregation_group_by_fields
-        #   The set of fields to preserve when crossSeriesReducer is specified. The
-        #   groupByFields determine how the time series are partitioned into subsets prior
-        #   to applying the aggregation function. Each subset contains time series that
-        #   have the same value for each of the grouping fields. Each individual time
-        #   series is a member of exactly one subset. The crossSeriesReducer is applied to
-        #   each subset of time series. It is not possible to reduce across different
-        #   resource types, so this field implicitly contains resource.type. Fields not
-        #   specified in groupByFields are aggregated away. If groupByFields is not
-        #   specified and all the time series have the same resource type, then the time
-        #   series are aggregated into a single output time series. If crossSeriesReducer
-        #   is not defined, this field is ignored.
-        # @param [String] aggregation_per_series_aligner
-        #   The approach to be used to align individual time series. Not all alignment
-        #   functions may be applied to all time series, depending on the metric type and
-        #   value type of the original time series. Alignment may change the metric type
-        #   or the value type of the time series.Time series data must be aligned in order
-        #   to perform cross-time series reduction. If crossSeriesReducer is specified,
-        #   then perSeriesAligner must be specified and not equal ALIGN_NONE and
-        #   alignmentPeriod must be specified; otherwise, an error is returned.
-        # @param [String] filter
-        #   A monitoring filter 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"
-        # @param [String] interval_end_time
-        #   Required. The end of the time interval.
-        # @param [String] interval_start_time
-        #   Optional. The beginning of the time interval. The default value for the start
-        #   time is the end time. The start time must not be later than the end time.
-        # @param [String] order_by
-        #   Unsupported: must be left blank. The points in each time series are returned
-        #   in reverse time order.
-        # @param [Fixnum] page_size
-        #   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.
-        # @param [String] page_token
-        #   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.
-        # @param [String] view
-        #   Specifies which information is returned about the time series.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::MonitoringV3::ListTimeSeriesResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::MonitoringV3::ListTimeSeriesResponse]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_time_series(name, aggregation_alignment_period: nil, aggregation_cross_series_reducer: nil, aggregation_group_by_fields: nil, aggregation_per_series_aligner: nil, filter: nil, interval_end_time: nil, interval_start_time: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v3/{+name}/timeSeries', options)
-          command.response_representation = Google::Apis::MonitoringV3::ListTimeSeriesResponse::Representation
-          command.response_class = Google::Apis::MonitoringV3::ListTimeSeriesResponse
-          command.params['name'] = name unless name.nil?
-          command.query['aggregation.alignmentPeriod'] = aggregation_alignment_period unless aggregation_alignment_period.nil?
-          command.query['aggregation.crossSeriesReducer'] = aggregation_cross_series_reducer unless aggregation_cross_series_reducer.nil?
-          command.query['aggregation.groupByFields'] = aggregation_group_by_fields unless aggregation_group_by_fields.nil?
-          command.query['aggregation.perSeriesAligner'] = aggregation_per_series_aligner unless aggregation_per_series_aligner.nil?
-          command.query['filter'] = filter unless filter.nil?
-          command.query['interval.endTime'] = interval_end_time unless interval_end_time.nil?
-          command.query['interval.startTime'] = interval_start_time unless interval_start_time.nil?
-          command.query['orderBy'] = order_by unless order_by.nil?
-          command.query['pageSize'] = page_size unless page_size.nil?
-          command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['view'] = view unless view.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Returns the list of IPs that checkers run from
         # @param [Fixnum] page_size
         #   The maximum number of results to return in a single response. The server may