classes.rb in google-api-client-0.37.0

- old
+ new

@@ -1348,11 +1348,11 @@
       class GoogleCloudMlV1RequestLoggingConfig
         include Google::Apis::Core::Hashable
       
         # 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>
         # <tr><th>Field name</th><th style="display: table-cell">Type</th>
         # <th style="display: table-cell">Mode</th></tr>
@@ -1390,11 +1390,11 @@
       # approximate the value rather than considering all subsets of features.
       class GoogleCloudMlV1SampledShapleyAttribution
         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
       
         def initialize(**args)
@@ -1405,10 +1405,48 @@
         def update!(**args)
           @num_paths = args[:num_paths] if args.key?(:num_paths)
         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
       
         def initialize(**args)
@@ -1541,13 +1579,24 @@
         # Corresponds to the JSON property `pythonModule`
         # @return [String]
         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
       
         # Required. The Google Compute Engine region to run the training job in.
@@ -1556,12 +1605,14 @@
         # Corresponds to the JSON property `region`
         # @return [String]
         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>.
         # Corresponds to the JSON property `runtimeVersion`
         # @return [String]
@@ -1571,10 +1622,15 @@
         # and parameter servers.
         # Corresponds to the JSON property `scaleTier`
         # @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.
         # Corresponds to the JSON property `useChiefInTfConfig`
         # @return [Boolean]
@@ -1630,10 +1686,11 @@
           @python_module = args[:python_module] if args.key?(:python_module)
           @python_version = args[:python_version] if args.key?(:python_version)
           @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)
           @worker_type = args[:worker_type] if args.key?(:worker_type)
         end
@@ -1915,12 +1972,24 @@
         # Corresponds to the JSON property `predictionClass`
         # @return [String]
         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
       
         # Configuration for logging request-response pairs to a BigQuery table.
@@ -1937,12 +2006,14 @@
         # Corresponds to the JSON property `requestLoggingConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1RequestLoggingConfig]
         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`
         # @return [String]
         attr_accessor :runtime_version
@@ -2106,14 +2177,32 @@
       
       # Associates `members` with a `role`.
       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
       
         # Specifies the identities requesting access for a Cloud Platform resource.
@@ -2560,37 +2649,53 @@
           @details = args[:details] if args.key?(:details)
           @message = args[:message] if args.key?(:message)
         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`
         # @return [String]
         attr_accessor :title