google-api-client 0.36.0 → 0.37.0

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

@@ -342,11 +342,10 @@ module Google
       end
       
       # Message holding configuration options for explaining model predictions.
-      # Currently, the only supported mechanism to explain a model's prediction is
-      # through attributing its output back to its inputs which is essentially a
-      # credit assignment task. We support multiple attribution methods, some
-      # specific to particular frameworks like Tensorflow and XGBoost.
-      # Next idx: 7.
+      # There are two feature attribution methods supported for TensorFlow models:
+      # integrated gradients and sampled Shapley.
+      # <a href="/ml-engine/docs/ai-explanations/overview">Learn more about feature
+      # attributions</a>.
       class GoogleCloudMlV1ExplanationConfig
         include Google::Apis::Core::Hashable
       
@@ -858,8 +857,7 @@ module Google
         # Each version is a trained model deployed in the cloud, ready to handle
         # prediction requests. A model can have multiple versions. You can get
         # information about all of the versions of a given model by calling
-        # [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-        # versions/list).
+        # projects.models.versions.list.
         # Corresponds to the JSON property `defaultVersion`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1Version]
         attr_accessor :default_version
@@ -1003,8 +1001,7 @@ module Google
         # Each version is a trained model deployed in the cloud, ready to handle
         # prediction requests. A model can have multiple versions. You can get
         # information about all of the versions of a given model by calling
-        # [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-        # versions/list).
+        # projects.models.versions.list.
         # Corresponds to the JSON property `version`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1Version]
         attr_accessor :version
@@ -1353,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>
@@ -1395,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
@@ -1410,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
@@ -1546,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
@@ -1561,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>.
@@ -1576,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.
@@ -1635,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)
@@ -1709,8 +1763,7 @@ module Google
       # Each version is a trained model deployed in the cloud, ready to handle
       # prediction requests. A model can have multiple versions. You can get
       # information about all of the versions of a given model by calling
-      # [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-      # versions/list).
+      # projects.models.versions.list.
       class GoogleCloudMlV1Version
         include Google::Apis::Core::Hashable
       
@@ -1739,8 +1792,7 @@ module Google
         # deployment](/ml-engine/docs/tensorflow/deploying-models) for more
         # information.
         # When passing Version to
-        # [projects.models.versions.create](/ml-engine/reference/rest/v1/projects.models.
-        # versions/create)
+        # projects.models.versions.create
         # the model service uses the specified location as the source of the model.
         # Once deployed, the model version is hosted by the prediction service, so
         # this location is useful only as a historical record.
@@ -1772,11 +1824,10 @@ module Google
         attr_accessor :etag
       
         # Message holding configuration options for explaining model predictions.
-        # Currently, the only supported mechanism to explain a model's prediction is
-        # through attributing its output back to its inputs which is essentially a
-        # credit assignment task. We support multiple attribution methods, some
-        # specific to particular frameworks like Tensorflow and XGBoost.
-        # Next idx: 7.
+        # There are two feature attribution methods supported for TensorFlow models:
+        # integrated gradients and sampled Shapley.
+        # <a href="/ml-engine/docs/ai-explanations/overview">Learn more about feature
+        # attributions</a>.
         # Corresponds to the JSON property `explanationConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1ExplanationConfig]
         attr_accessor :explanation_config
@@ -1800,8 +1851,7 @@ module Google
         # Output only. If true, this version will be used to handle prediction
         # requests that do not specify a version.
         # You can change the default version by calling
-        # [projects.methods.versions.setDefault](/ml-engine/reference/rest/v1/projects.
-        # models.versions/setDefault).
+        # projects.methods.versions.setDefault.
         # Corresponds to the JSON property `isDefault`
         # @return [Boolean]
         attr_accessor :is_default
@@ -1924,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
@@ -1946,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`
@@ -2115,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
@@ -2137,7 +2219,7 @@ module Google
         # For example, `admins@example.com`.
         # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
         # identifier) representing a user that has been recently deleted. For
-        # example,`alice@example.com?uid=123456789012345678901`. If the user is
+        # example, `alice@example.com?uid=123456789012345678901`. If the user is
         # recovered, this value reverts to `user:`emailid`` and the recovered user
         # retains the role in the binding.
         # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
@@ -2569,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

@@ -49,8 +49,7 @@ module Google
         
         # Performs explanation on the data in the request.
         # AI Platform implements a custom `explain` verb on top of an HTTP POST
-        # method. <p>For details of the request and response format, see the **guide
-        # to the [explain request format](/ml-engine/docs/v1/explain-request)**.
+        # method.
         # @param [String] name
         #   Required. The resource name of a model or a version.
         #   Authorization: requires the `predict` permission on the specified resource.
@@ -117,10 +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. <p>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.
@@ -549,8 +546,7 @@ module Google
         # Creates a model which will later contain one or more versions.
         # You must add at least one version before you can request predictions from
         # the model. Add versions by calling
-        # [projects.models.versions.create](/ml-engine/reference/rest/v1/projects.models.
-        # versions/create).
+        # projects.models.versions.create.
         # @param [String] parent
         #   Required. The project name.
         # @param [Google::Apis::MlV1::GoogleCloudMlV1Model] google_cloud_ml_v1__model_object
@@ -586,8 +582,7 @@ module Google
         # Deletes a model.
         # You can only delete a model if there are no versions in it. You can delete
         # versions by calling
-        # [projects.models.versions.delete](/ml-engine/reference/rest/v1/projects.models.
-        # versions/delete).
+        # projects.models.versions.delete.
         # @param [String] name
         #   Required. The name of the model.
         # @param [String] fields
@@ -869,8 +864,7 @@ module Google
         # model. When you add a version to a model that already has one or more
         # versions, the default version does not automatically change. If you want a
         # new version to be the default, you must call
-        # [projects.models.versions.setDefault](/ml-engine/reference/rest/v1/projects.
-        # models.versions/setDefault).
+        # projects.models.versions.setDefault.
         # @param [String] parent
         #   Required. The name of the model.
         # @param [Google::Apis::MlV1::GoogleCloudMlV1Version] google_cloud_ml_v1__version_object
@@ -911,8 +905,7 @@ module Google
         # @param [String] name
         #   Required. The name of the version. You can get the names of all the
         #   versions of a model by calling
-        #   [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-        #   versions/list).
+        #   projects.models.versions.list.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -942,8 +935,7 @@ module Google
         
         # Gets information about a model version.
         # Models can have multiple versions. You can call
-        # [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-        # versions/list)
+        # projects.models.versions.list
         # to get the same information that this method returns for all of the
         # versions of a model.
         # @param [String] name
@@ -1025,8 +1017,8 @@ module Google
         end
         
         # Updates the specified Version resource.
-        # Currently the only update-able fields are `description` and
-        # `autoScaling.minNodes`.
+        # Currently the only update-able fields are `description`,
+        # `requestLoggingConfig`, `autoScaling.minNodes`, and `manualScaling.nodes`.
         # @param [String] name
         #   Required. The name of the model.
         # @param [Google::Apis::MlV1::GoogleCloudMlV1Version] google_cloud_ml_v1__version_object
@@ -1042,8 +1034,9 @@ module Google
         #   `
         #   ```
         #   Currently the only supported update mask fields are `description`,
-        #   `autoScaling.minNodes`, and `manualScaling.nodes`. However, you can only
-        #   update `manualScaling.nodes` if the version uses a [Compute Engine (N1)
+        #   `requestLoggingConfig`, `autoScaling.minNodes`, and `manualScaling.nodes`.
+        #   However, you can only update `manualScaling.nodes` if the version uses a
+        #   [Compute Engine (N1)
         #   machine type](/ml-engine/docs/machine-types-online-prediction).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1084,8 +1077,7 @@ module Google
         # @param [String] name
         #   Required. The name of the version to make the default for the model. You
         #   can get the names of all the versions of a model by calling
-        #   [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-        #   versions/list).
+        #   projects.models.versions.list.
         # @param [Google::Apis::MlV1::GoogleCloudMlV1SetDefaultVersionRequest] google_cloud_ml_v1__set_default_version_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/ml_v1.rb

@@ -25,10 +25,13 @@ module Google
     # @see https://cloud.google.com/ml/
     module MlV1
       VERSION = 'V1'
-      REVISION = '20191122'
+      REVISION = '20200207'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+
+      # View your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM_READ_ONLY = 'https://www.googleapis.com/auth/cloud-platform.read-only'
     end
   end
 end