google-api-client 0.36.4 → 0.37.0

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

@@ -1350,7 +1350,7 @@ module Google
       
         # Required. Fully qualified BigQuery table name in the following format:
         # "<var>project_id</var>.<var>dataset_name</var>.<var>table_name</var>"
-        # The specifcied table must already exist, and the "Cloud ML Service Agent"
+        # The specified table must already exist, and the "Cloud ML Service Agent"
         # for your project must have permission to write to it. The table must have
         # the following [schema](/bigquery/docs/schemas):
         # <table>
@@ -1392,7 +1392,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The number of feature permutations to consider when approximating the
-        # shapley values.
+        # Shapley values.
         # Corresponds to the JSON property `numPaths`
         # @return [Fixnum]
         attr_accessor :num_paths
@@ -1407,6 +1407,44 @@ module Google
         end
       end
       
+      # All parameters related to scheduling of training jobs.
+      class GoogleCloudMlV1Scheduling
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The maximum job running time, expressed in seconds. The field can
+        # contain up to nine fractional digits, terminated by `s`. By default there
+        # is no limit to the running time.
+        # If the training job is still running after this duration, AI Platform
+        # Training cancels it.
+        # For example, if you want to ensure your job runs for no more than 2 hours,
+        # set this field to `7200s` (2 hours * 60 minutes / hour * 60 seconds /
+        # minute).
+        # If you submit your training job using the `gcloud` tool, you can [provide
+        # this field in a `config.yaml`
+        # file](/ai-platform/training/docs/training-jobs#
+        # formatting_your_configuration_parameters).
+        # For example:
+        # ```yaml
+        # trainingInput:
+        # ...
+        # scheduling:
+        # maxRunningTime: 7200s
+        # ...
+        # ```
+        # Corresponds to the JSON property `maxRunningTime`
+        # @return [String]
+        attr_accessor :max_running_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_running_time = args[:max_running_time] if args.key?(:max_running_time)
+        end
+      end
+      
       # Request message for the SetDefaultVersion request.
       class GoogleCloudMlV1SetDefaultVersionRequest
         include Google::Apis::Core::Hashable
@@ -1543,9 +1581,20 @@ module Google
         attr_accessor :python_module
       
         # Optional. The version of Python used in training. If not set, the default
-        # version is '2.7'. Python '3.5' is available when `runtime_version` is set
-        # to '1.4' and above. Python '2.7' works with all supported
-        # <a href="/ml-engine/docs/runtime-version-list">runtime versions</a>.
+        # version is '2.7'. Starting [January 13,
+        # 2020](/ml-engine/docs/release-notes#december_10_2019), this field is
+        # required.
+        # The following Python versions are available:
+        # * Python '3.7' is available when `runtime_version` is set to '1.15' or
+        # later.
+        # * Python '3.5' is available when `runtime_version` is set to a version
+        # from '1.4' to '1.14'.
+        # * Python '2.7' is available when `runtime_version` is set to '1.15' or
+        # earlier. (Runtime versions released [after January 1,
+        # 2020](/ml-engine/docs/release-notes#december_10_2019) do not support
+        # Python 2.7.)
+        # Read more about the Python versions available for [each runtime
+        # version](/ml-engine/docs/runtime-version-list).
         # Corresponds to the JSON property `pythonVersion`
         # @return [String]
         attr_accessor :python_version
@@ -1558,8 +1607,10 @@ module Google
         attr_accessor :region
       
         # Optional. The AI Platform runtime version to use for training. If not
-        # set, AI Platform uses the default stable version, 1.0. For more
-        # information, see the
+        # set, AI Platform uses the default stable version, 1.0. Starting [January
+        # 13, 2020](/ml-engine/docs/release-notes#december_10_2019), this field is
+        # required.
+        # For more information, see the
         # <a href="/ml-engine/docs/runtime-version-list">runtime version list</a>
         # and
         # <a href="/ml-engine/docs/versioning">how to manage runtime versions</a>.
@@ -1573,6 +1624,11 @@ module Google
         # @return [String]
         attr_accessor :scale_tier
       
+        # All parameters related to scheduling of training jobs.
+        # Corresponds to the JSON property `scheduling`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1Scheduling]
+        attr_accessor :scheduling
+      
         # Optional. Use 'chief' instead of 'master' in TF_CONFIG when Custom
         # Container is used and evaluator is not specified.
         # Defaults to false.
@@ -1632,6 +1688,7 @@ module Google
           @region = args[:region] if args.key?(:region)
           @runtime_version = args[:runtime_version] if args.key?(:runtime_version)
           @scale_tier = args[:scale_tier] if args.key?(:scale_tier)
+          @scheduling = args[:scheduling] if args.key?(:scheduling)
           @use_chief_in_tf_config = args[:use_chief_in_tf_config] if args.key?(:use_chief_in_tf_config)
           @worker_config = args[:worker_config] if args.key?(:worker_config)
           @worker_count = args[:worker_count] if args.key?(:worker_count)
@@ -1917,8 +1974,20 @@ module Google
         attr_accessor :prediction_class
       
         # Optional. The version of Python used in prediction. If not set, the default
-        # version is '2.7'. Python '3.5' is available when `runtime_version` is set
-        # to '1.4' and above. Python '2.7' works with all supported runtime versions.
+        # version is '2.7'. Starting [January 13,
+        # 2020](/ml-engine/docs/release-notes#december_10_2019), this field is
+        # required.
+        # The following Python versions are available:
+        # * Python '3.7' is available when `runtime_version` is set to '1.15' or
+        # later.
+        # * Python '3.5' is available when `runtime_version` is set to a version
+        # from '1.4' to '1.14'.
+        # * Python '2.7' is available when `runtime_version` is set to '1.15' or
+        # earlier. (Runtime versions released [after January 1,
+        # 2020](/ml-engine/docs/release-notes#december_10_2019) do not support
+        # Python 2.7.)
+        # Read more about the Python versions available for [each runtime
+        # version](/ml-engine/docs/runtime-version-list).
         # Corresponds to the JSON property `pythonVersion`
         # @return [String]
         attr_accessor :python_version
@@ -1939,8 +2008,10 @@ module Google
         attr_accessor :request_logging_config
       
         # Optional. The AI Platform runtime version to use for this deployment.
-        # If not set, AI Platform uses the default stable version, 1.0. For more
-        # information, see the
+        # If not set, AI Platform uses the default stable version, 1.0. Starting
+        # [January 13, 2020](/ml-engine/docs/release-notes#december_10_2019), this
+        # field is required.
+        # For more information, see the
         # [runtime version list](/ml-engine/docs/runtime-version-list) and
         # [how to manage runtime versions](/ml-engine/docs/versioning).
         # Corresponds to the JSON property `runtimeVersion`
@@ -2108,10 +2179,28 @@ module Google
       class GoogleIamV1Binding
         include Google::Apis::Core::Hashable
       
-        # Represents an expression text. Example:
-        # title: "User account presence"
-        # description: "Determines whether the request has a user account"
-        # expression: "size(request.user) > 0"
+        # Represents a textual expression in the Common Expression Language (CEL)
+        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # are documented at https://github.com/google/cel-spec.
+        # Example (Comparison):
+        # title: "Summary size limit"
+        # description: "Determines if a summary is less than 100 chars"
+        # expression: "document.summary.size() < 100"
+        # Example (Equality):
+        # title: "Requestor is owner"
+        # description: "Determines if requestor is the document owner"
+        # expression: "document.owner == request.auth.claims.email"
+        # Example (Logic):
+        # title: "Public documents"
+        # description: "Determine whether the document should be publicly visible"
+        # expression: "document.type != 'private' && document.type != 'internal'"
+        # Example (Data Manipulation):
+        # title: "Notification string"
+        # description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)"
+        # The exact variables and functions that may be referenced within an expression
+        # are determined by the service that evaluates it. See the service
+        # documentation for additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::MlV1::GoogleTypeExpr]
         attr_accessor :condition
@@ -2562,34 +2651,50 @@ module Google
         end
       end
       
-      # Represents an expression text. Example:
-      # title: "User account presence"
-      # description: "Determines whether the request has a user account"
-      # expression: "size(request.user) > 0"
+      # Represents a textual expression in the Common Expression Language (CEL)
+      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # are documented at https://github.com/google/cel-spec.
+      # Example (Comparison):
+      # title: "Summary size limit"
+      # description: "Determines if a summary is less than 100 chars"
+      # expression: "document.summary.size() < 100"
+      # Example (Equality):
+      # title: "Requestor is owner"
+      # description: "Determines if requestor is the document owner"
+      # expression: "document.owner == request.auth.claims.email"
+      # Example (Logic):
+      # title: "Public documents"
+      # description: "Determine whether the document should be publicly visible"
+      # expression: "document.type != 'private' && document.type != 'internal'"
+      # Example (Data Manipulation):
+      # title: "Notification string"
+      # description: "Create a notification string with a timestamp."
+      # expression: "'New message received at ' + string(document.create_time)"
+      # The exact variables and functions that may be referenced within an expression
+      # are determined by the service that evaluates it. See the service
+      # documentation for additional information.
       class GoogleTypeExpr
         include Google::Apis::Core::Hashable
       
-        # An optional description of the expression. This is a longer text which
+        # Optional. Description of the expression. This is a longer text which
         # describes the expression, e.g. when hovered over it in a UI.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Textual representation of an expression in
-        # Common Expression Language syntax.
-        # The application context of the containing message determines which
-        # well-known feature set of CEL is supported.
+        # Textual representation of an expression in Common Expression Language
+        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # An optional string indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error
         # reporting, e.g. a file name and a position in the file.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # An optional title for the expression, i.e. a short string describing
+        # Optional. Title for the expression, i.e. a short string describing
         # its purpose. This can be used e.g. in UIs which allow to enter the
         # expression.
         # Corresponds to the JSON property `title`

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

@@ -202,6 +202,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudMlV1Scheduling
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudMlV1SetDefaultVersionRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -609,6 +615,13 @@ module Google
         end
       end
       
+      class GoogleCloudMlV1Scheduling
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :max_running_time, as: 'maxRunningTime'
+        end
+      end
+      
       class GoogleCloudMlV1SetDefaultVersionRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -635,6 +648,8 @@ module Google
           property :region, as: 'region'
           property :runtime_version, as: 'runtimeVersion'
           property :scale_tier, as: 'scaleTier'
+          property :scheduling, as: 'scheduling', class: Google::Apis::MlV1::GoogleCloudMlV1Scheduling, decorator: Google::Apis::MlV1::GoogleCloudMlV1Scheduling::Representation
+      
           property :use_chief_in_tf_config, as: 'useChiefInTfConfig'
           property :worker_config, as: 'workerConfig', class: Google::Apis::MlV1::GoogleCloudMlV1ReplicaConfig, decorator: Google::Apis::MlV1::GoogleCloudMlV1ReplicaConfig::Representation
       

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

@@ -50,8 +50,6 @@ module Google
         # Performs explanation on the data in the request.
         # AI Platform implements a custom `explain` verb on top of an HTTP POST
         # method.
-        # For details of the request and response format, see the **guide
-        # to the [explain request format](/ml-engine/docs/v1/explain-request)**.
         # @param [String] name
         #   Required. The resource name of a model or a version.
         #   Authorization: requires the `predict` permission on the specified resource.
@@ -118,11 +116,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Performs prediction on the data in the request.
-        # AI Platform implements a custom `predict` verb on top of an HTTP POST
-        # method.
-        # For details of the request and response format, see the **guide
-        # to the [predict request format](/ml-engine/docs/v1/predict-request)**.
+        # Performs online prediction on the data in the request.
+        # <div>`% dynamic include "/ai-platform/includes/___predict-request" %`</div>
         # @param [String] name
         #   Required. The resource name of a model or a version.
         #   Authorization: requires the `predict` permission on the specified resource.

data/generated/google/apis/monitoring_v1.rb

@@ -30,7 +30,7 @@ module Google
     # @see https://cloud.google.com/monitoring/api/
     module MonitoringV1
       VERSION = 'V1'
-      REVISION = '20191207'
+      REVISION = '20200210'
 
       # 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_v1/classes.rb

@@ -22,57 +22,81 @@ module Google
   module Apis
     module MonitoringV1
       
-      # Describes how to combine multiple time series to provide different views of
-      # the data. Aggregation consists of an alignment step on individual time series (
-      # alignment_period and per_series_aligner) followed by an optional reduction
-      # step of the data across the aligned time series (cross_series_reducer and
-      # group_by_fields). For more details, see Aggregation.
+      # Describes how to combine multiple time series to provide a different view of
+      # the data. Aggregation of time series is done in two steps. First, each time
+      # series in the set is aligned to the same time interval boundaries, then the
+      # set of time series is optionally reduced in number.Alignment consists of
+      # applying the per_series_aligner operation to each time series after its data
+      # has been divided into regular alignment_period time intervals. This process
+      # takes all of the data points in an alignment period, applies a mathematical
+      # transformation such as averaging, minimum, maximum, delta, etc., and converts
+      # them into a single data point per period.Reduction is when the aligned and
+      # transformed time series can optionally be combined, reducing the number of
+      # time series through similar mathematical transformations. Reduction involves
+      # applying a cross_series_reducer to all the time series, optionally sorting the
+      # time series into subsets with group_by_fields, and applying the reducer to
+      # each subset.The raw time series data can contain a huge amount of information
+      # from multiple sources. Alignment and reduction transforms this mass of data
+      # into a more manageable and representative collection of data, for example "the
+      # 95% latency across the average of all tasks in a cluster". This representative
+      # data can be more easily graphed and comprehended, and the individual time
+      # series data is still available for later drilldown. For more details, see
+      # Aggregating Time Series.
       class Aggregation
         include Google::Apis::Core::Hashable
       
-        # 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.
+        # The alignment_period specifies a time interval, in seconds, that is used to
+        # divide the data in all the time series into consistent blocks of time. This
+        # will be done before the per-series aligner can be applied to the data.The
+        # value must be at least 60 seconds. If a per-series aligner other than
+        # ALIGN_NONE is specified, this field is required or an error is returned. If no
+        # per-series aligner is specified, or the aligner ALIGN_NONE is specified, then
+        # this field is ignored.
         # Corresponds to the JSON property `alignmentPeriod`
         # @return [String]
         attr_accessor :alignment_period
       
-        # 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.
+        # The reduction operation to be used to combine time series into a single time
+        # series, where the value of each data point in the resulting series is a
+        # function of all the already aligned values in the input time series.Not all
+        # reducer operations can be applied to all time series. The valid choices depend
+        # on the metric_kind and the value_type of the original time series. Reduction
+        # can yield a time series with a different metric_kind or value_type than the
+        # input time series.Time series data must first be aligned (see
+        # per_series_aligner) in order to perform cross-time series reduction. If
+        # cross_series_reducer is specified, then per_series_aligner must be specified,
+        # and must not be ALIGN_NONE. An alignment_period must also be specified;
+        # otherwise, an error is returned.
         # Corresponds to the JSON property `crossSeriesReducer`
         # @return [String]
         attr_accessor :cross_series_reducer
       
-        # 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
+        # The set of fields to preserve when cross_series_reducer is specified. The
+        # group_by_fields determine how the time series are partitioned into subsets
+        # prior to applying the aggregation operation. 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 cross_series_reducer 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 in group_by_fields are aggregated away. If group_by_fields 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.
+        # series are aggregated into a single output time series. If
+        # cross_series_reducer is not defined, this field is ignored.
         # Corresponds to the JSON property `groupByFields`
         # @return [Array<String>]
         attr_accessor :group_by_fields
       
-        # 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.
+        # An Aligner describes how to bring the data points in a single time series into
+        # temporal alignment. Except for ALIGN_NONE, all alignments cause all the data
+        # points in an alignment_period to be mathematically grouped together, resulting
+        # in a single data point for each alignment_period with end timestamp at the end
+        # of the period.Not all alignment operations may be applied to all time series.
+        # The valid choices depend on the metric_kind and value_type of the original
+        # time series. Alignment can change the metric_kind or the value_type of the
+        # time series.Time series data must be aligned in order to perform cross-time
+        # series reduction. If cross_series_reducer is specified, then
+        # per_series_aligner must be specified and not equal to ALIGN_NONE and
+        # alignment_period must be specified; otherwise, an error is returned.
         # Corresponds to the JSON property `perSeriesAligner`
         # @return [String]
         attr_accessor :per_series_aligner
@@ -474,8 +498,8 @@ module Google
         attr_accessor :dashboards
       
         # 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.
+        # non-empty value. To see the additional results, use that value as page_token
+        # in the next call to this method.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -524,8 +548,11 @@ module Google
       end
       
       # Describes a ranking-based time series filter. Each input time series is ranked
-      # with an aligner. The filter lets through up to num_time_series time series,
-      # selecting them based on the relative ranking.
+      # with an aligner. The filter will allow up to num_time_series time series to
+      # pass through it, selecting them based on the relative ranking.For example, if
+      # ranking_method is METHOD_MEAN,direction is BOTTOM, and num_time_series is 3,
+      # then the 3 times series with the lowest mean values will pass through the
+      # filter.
       class PickTimeSeriesFilter
         include Google::Apis::Core::Hashable
       
@@ -534,12 +561,12 @@ module Google
         # @return [String]
         attr_accessor :direction
       
-        # How many time series to return.
+        # How many time series to allow to pass through the filter.
         # Corresponds to the JSON property `numTimeSeries`
         # @return [Fixnum]
         attr_accessor :num_time_series
       
-        # rankingMethod is applied to each time series independently to produce the
+        # ranking_method is applied to each time series independently to produce the
         # value which will be used to compare the time series to other time series.
         # Corresponds to the JSON property `rankingMethod`
         # @return [String]
@@ -562,11 +589,26 @@ module Google
       class RatioPart
         include Google::Apis::Core::Hashable
       
-        # Describes how to combine multiple time series to provide different views of
-        # the data. Aggregation consists of an alignment step on individual time series (
-        # alignment_period and per_series_aligner) followed by an optional reduction
-        # step of the data across the aligned time series (cross_series_reducer and
-        # group_by_fields). For more details, see Aggregation.
+        # Describes how to combine multiple time series to provide a different view of
+        # the data. Aggregation of time series is done in two steps. First, each time
+        # series in the set is aligned to the same time interval boundaries, then the
+        # set of time series is optionally reduced in number.Alignment consists of
+        # applying the per_series_aligner operation to each time series after its data
+        # has been divided into regular alignment_period time intervals. This process
+        # takes all of the data points in an alignment period, applies a mathematical
+        # transformation such as averaging, minimum, maximum, delta, etc., and converts
+        # them into a single data point per period.Reduction is when the aligned and
+        # transformed time series can optionally be combined, reducing the number of
+        # time series through similar mathematical transformations. Reduction involves
+        # applying a cross_series_reducer to all the time series, optionally sorting the
+        # time series into subsets with group_by_fields, and applying the reducer to
+        # each subset.The raw time series data can contain a huge amount of information
+        # from multiple sources. Alignment and reduction transforms this mass of data
+        # into a more manageable and representative collection of data, for example "the
+        # 95% latency across the average of all tasks in a cluster". This representative
+        # data can be more easily graphed and comprehended, and the individual time
+        # series data is still available for later drilldown. For more details, see
+        # Aggregating Time Series.
         # Corresponds to the JSON property `aggregation`
         # @return [Google::Apis::MonitoringV1::Aggregation]
         attr_accessor :aggregation
@@ -714,16 +756,16 @@ module Google
         end
       end
       
-      # The context of a span, attached to google.api.Distribution.Exemplars in google.
-      # api.Distribution values during aggregation.It contains the name of a span with
-      # format:  projects/PROJECT_ID/traces/TRACE_ID/spans/SPAN_ID
+      # The context of a span, attached to Exemplars in Distribution values during
+      # aggregation.It contains the name of a span with format:
+      # projects/[PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID]
       class SpanContext
         include Google::Apis::Core::Hashable
       
-        # The resource name of the span in the following format:
-        # projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
-        # TRACE_ID is a unique identifier for a trace within a project; it is a 32-
-        # character hexadecimal encoding of a 16-byte array.SPAN_ID is a unique
+        # The resource name of the span. The format is:
+        # projects/[PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID]
+        # [TRACE_ID] is a unique identifier for a trace within a project; it is a 32-
+        # character hexadecimal encoding of a 16-byte array.[SPAN_ID] is a unique
         # identifier for a span within a trace; it is a 16-character hexadecimal
         # encoding of an 8-byte array.
         # Corresponds to the JSON property `spanName`
@@ -771,35 +813,6 @@ module Google
         end
       end
       
-      # A filter that ranks streams based on their statistical relation to other
-      # streams in a request.
-      class StatisticalTimeSeriesFilter
-        include Google::Apis::Core::Hashable
-      
-        # How many time series to output.
-        # Corresponds to the JSON property `numTimeSeries`
-        # @return [Fixnum]
-        attr_accessor :num_time_series
-      
-        # rankingMethod is applied to a set of time series, and then the produced value
-        # for each individual time series is used to compare a given time series to
-        # others. These are methods that cannot be applied stream-by-stream, but rather
-        # require the full context of a request to evaluate time series.
-        # Corresponds to the JSON property `rankingMethod`
-        # @return [String]
-        attr_accessor :ranking_method
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @num_time_series = args[:num_time_series] if args.key?(:num_time_series)
-          @ranking_method = args[:ranking_method] if args.key?(:ranking_method)
-        end
-      end
-      
       # A widget that displays textual content.
       class Text
         include Google::Apis::Core::Hashable
@@ -868,11 +881,26 @@ module Google
       class TimeSeriesFilter
         include Google::Apis::Core::Hashable
       
-        # Describes how to combine multiple time series to provide different views of
-        # the data. Aggregation consists of an alignment step on individual time series (
-        # alignment_period and per_series_aligner) followed by an optional reduction
-        # step of the data across the aligned time series (cross_series_reducer and
-        # group_by_fields). For more details, see Aggregation.
+        # Describes how to combine multiple time series to provide a different view of
+        # the data. Aggregation of time series is done in two steps. First, each time
+        # series in the set is aligned to the same time interval boundaries, then the
+        # set of time series is optionally reduced in number.Alignment consists of
+        # applying the per_series_aligner operation to each time series after its data
+        # has been divided into regular alignment_period time intervals. This process
+        # takes all of the data points in an alignment period, applies a mathematical
+        # transformation such as averaging, minimum, maximum, delta, etc., and converts
+        # them into a single data point per period.Reduction is when the aligned and
+        # transformed time series can optionally be combined, reducing the number of
+        # time series through similar mathematical transformations. Reduction involves
+        # applying a cross_series_reducer to all the time series, optionally sorting the
+        # time series into subsets with group_by_fields, and applying the reducer to
+        # each subset.The raw time series data can contain a huge amount of information
+        # from multiple sources. Alignment and reduction transforms this mass of data
+        # into a more manageable and representative collection of data, for example "the
+        # 95% latency across the average of all tasks in a cluster". This representative
+        # data can be more easily graphed and comprehended, and the individual time
+        # series data is still available for later drilldown. For more details, see
+        # Aggregating Time Series.
         # Corresponds to the JSON property `aggregation`
         # @return [Google::Apis::MonitoringV1::Aggregation]
         attr_accessor :aggregation
@@ -884,18 +912,15 @@ module Google
         attr_accessor :filter
       
         # Describes a ranking-based time series filter. Each input time series is ranked
-        # with an aligner. The filter lets through up to num_time_series time series,
-        # selecting them based on the relative ranking.
+        # with an aligner. The filter will allow up to num_time_series time series to
+        # pass through it, selecting them based on the relative ranking.For example, if
+        # ranking_method is METHOD_MEAN,direction is BOTTOM, and num_time_series is 3,
+        # then the 3 times series with the lowest mean values will pass through the
+        # filter.
         # Corresponds to the JSON property `pickTimeSeriesFilter`
         # @return [Google::Apis::MonitoringV1::PickTimeSeriesFilter]
         attr_accessor :pick_time_series_filter
       
-        # A filter that ranks streams based on their statistical relation to other
-        # streams in a request.
-        # Corresponds to the JSON property `statisticalTimeSeriesFilter`
-        # @return [Google::Apis::MonitoringV1::StatisticalTimeSeriesFilter]
-        attr_accessor :statistical_time_series_filter
-      
         def initialize(**args)
            update!(**args)
         end
@@ -905,7 +930,6 @@ module Google
           @aggregation = args[:aggregation] if args.key?(:aggregation)
           @filter = args[:filter] if args.key?(:filter)
           @pick_time_series_filter = args[:pick_time_series_filter] if args.key?(:pick_time_series_filter)
-          @statistical_time_series_filter = args[:statistical_time_series_filter] if args.key?(:statistical_time_series_filter)
         end
       end
       
@@ -928,27 +952,39 @@ module Google
         attr_accessor :numerator
       
         # Describes a ranking-based time series filter. Each input time series is ranked
-        # with an aligner. The filter lets through up to num_time_series time series,
-        # selecting them based on the relative ranking.
+        # with an aligner. The filter will allow up to num_time_series time series to
+        # pass through it, selecting them based on the relative ranking.For example, if
+        # ranking_method is METHOD_MEAN,direction is BOTTOM, and num_time_series is 3,
+        # then the 3 times series with the lowest mean values will pass through the
+        # filter.
         # Corresponds to the JSON property `pickTimeSeriesFilter`
         # @return [Google::Apis::MonitoringV1::PickTimeSeriesFilter]
         attr_accessor :pick_time_series_filter
       
-        # Describes how to combine multiple time series to provide different views of
-        # the data. Aggregation consists of an alignment step on individual time series (
-        # alignment_period and per_series_aligner) followed by an optional reduction
-        # step of the data across the aligned time series (cross_series_reducer and
-        # group_by_fields). For more details, see Aggregation.
+        # Describes how to combine multiple time series to provide a different view of
+        # the data. Aggregation of time series is done in two steps. First, each time
+        # series in the set is aligned to the same time interval boundaries, then the
+        # set of time series is optionally reduced in number.Alignment consists of
+        # applying the per_series_aligner operation to each time series after its data
+        # has been divided into regular alignment_period time intervals. This process
+        # takes all of the data points in an alignment period, applies a mathematical
+        # transformation such as averaging, minimum, maximum, delta, etc., and converts
+        # them into a single data point per period.Reduction is when the aligned and
+        # transformed time series can optionally be combined, reducing the number of
+        # time series through similar mathematical transformations. Reduction involves
+        # applying a cross_series_reducer to all the time series, optionally sorting the
+        # time series into subsets with group_by_fields, and applying the reducer to
+        # each subset.The raw time series data can contain a huge amount of information
+        # from multiple sources. Alignment and reduction transforms this mass of data
+        # into a more manageable and representative collection of data, for example "the
+        # 95% latency across the average of all tasks in a cluster". This representative
+        # data can be more easily graphed and comprehended, and the individual time
+        # series data is still available for later drilldown. For more details, see
+        # Aggregating Time Series.
         # Corresponds to the JSON property `secondaryAggregation`
         # @return [Google::Apis::MonitoringV1::Aggregation]
         attr_accessor :secondary_aggregation
       
-        # A filter that ranks streams based on their statistical relation to other
-        # streams in a request.
-        # Corresponds to the JSON property `statisticalTimeSeriesFilter`
-        # @return [Google::Apis::MonitoringV1::StatisticalTimeSeriesFilter]
-        attr_accessor :statistical_time_series_filter
-      
         def initialize(**args)
            update!(**args)
         end
@@ -959,7 +995,6 @@ module Google
           @numerator = args[:numerator] if args.key?(:numerator)
           @pick_time_series_filter = args[:pick_time_series_filter] if args.key?(:pick_time_series_filter)
           @secondary_aggregation = args[:secondary_aggregation] if args.key?(:secondary_aggregation)
-          @statistical_time_series_filter = args[:statistical_time_series_filter] if args.key?(:statistical_time_series_filter)
         end
       end