google-api-client 0.43.0 → 0.48.0

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

@@ -23,34 +23,21 @@ module Google
     module MlV1
       
       # Message that represents an arbitrary HTTP body. It should only be used for
-      # payload formats that can't be represented as JSON, such as raw binary or
-      # an HTML page.
-      # This message can be used both in streaming and non-streaming API methods in
-      # the request as well as the response.
-      # It can be used as a top-level request field, which is convenient if one
-      # wants to extract parameters from either the URL or HTTP template into the
-      # request fields and also want access to the raw HTTP body.
-      # Example:
-      # message GetResourceRequest `
-      # // A unique request id.
-      # string request_id = 1;
-      # // The raw HTTP body is bound to this field.
-      # google.api.HttpBody http_body = 2;
-      # `
-      # service ResourceService `
-      # rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
-      # rpc UpdateResource(google.api.HttpBody) returns
-      # (google.protobuf.Empty);
-      # `
-      # Example with streaming methods:
-      # service CaldavService `
-      # rpc GetCalendar(stream google.api.HttpBody)
-      # returns (stream google.api.HttpBody);
-      # rpc UpdateCalendar(stream google.api.HttpBody)
-      # returns (stream google.api.HttpBody);
-      # `
-      # Use of this type only changes how the request and response bodies are
-      # handled, all other features will continue to work unchanged.
+      # payload formats that can't be represented as JSON, such as raw binary or an
+      # HTML page. This message can be used both in streaming and non-streaming API
+      # methods in the request as well as the response. It can be used as a top-level
+      # request field, which is convenient if one wants to extract parameters from
+      # either the URL or HTTP template into the request fields and also want access
+      # to the raw HTTP body. Example: message GetResourceRequest ` // A unique
+      # request id. string request_id = 1; // The raw HTTP body is bound to this field.
+      # google.api.HttpBody http_body = 2; ` service ResourceService ` rpc
+      # GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc
+      # UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); ` Example
+      # with streaming methods: service CaldavService ` rpc GetCalendar(stream google.
+      # api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream
+      # google.api.HttpBody) returns (stream google.api.HttpBody); ` Use of this type
+      # only changes how the request and response bodies are handled, all other
+      # features will continue to work unchanged.
       class GoogleApiHttpBody
         include Google::Apis::Core::Hashable
       
@@ -65,8 +52,8 @@ module Google
         # @return [String]
         attr_accessor :data
       
-        # Application specific response metadata. Must be set in the first response
-        # for streaming APIs.
+        # Application specific response metadata. Must be set in the first response for
+        # streaming APIs.
         # Corresponds to the JSON property `extensions`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :extensions
@@ -87,9 +74,8 @@ module Google
       class GoogleCloudMlV1AutomatedStoppingConfigDecayCurveAutomatedStoppingConfig
         include Google::Apis::Core::Hashable
       
-        # If true, measurement.elapsed_time is used as the x-axis of each
-        # Trials Decay Curve. Otherwise, Measurement.steps will be used as the
-        # x-axis.
+        # If true, measurement.elapsed_time is used as the x-axis of each Trials Decay
+        # Curve. Otherwise, Measurement.steps will be used as the x-axis.
         # Corresponds to the JSON property `useElapsedTime`
         # @return [Boolean]
         attr_accessor :use_elapsed_time
@@ -105,19 +91,18 @@ module Google
         end
       end
       
-      # The median automated stopping rule stops a pending trial if the trial's
-      # best objective_value is strictly below the median 'performance' of all
-      # completed trials reported up to the trial's last measurement.
-      # Currently, 'performance' refers to the running average of the objective
-      # values reported by the trial in each measurement.
+      # The median automated stopping rule stops a pending trial if the trial's best
+      # objective_value is strictly below the median 'performance' of all completed
+      # trials reported up to the trial's last measurement. Currently, 'performance'
+      # refers to the running average of the objective values reported by the trial in
+      # each measurement.
       class GoogleCloudMlV1AutomatedStoppingConfigMedianAutomatedStoppingConfig
         include Google::Apis::Core::Hashable
       
-        # If true, the median automated stopping rule applies to
-        # measurement.use_elapsed_time, which means the elapsed_time field of
-        # the current trial's
-        # latest measurement is used to compute the median objective
-        # value for each completed trial.
+        # If true, the median automated stopping rule applies to measurement.
+        # use_elapsed_time, which means the elapsed_time field of the current trial's
+        # latest measurement is used to compute the median objective value for each
+        # completed trial.
         # Corresponds to the JSON property `useElapsedTime`
         # @return [Boolean]
         attr_accessor :use_elapsed_time
@@ -187,8 +172,7 @@ module Google
       class GoogleCloudMlV1StudyConfigParameterSpecCategoricalValueSpec
         include Google::Apis::Core::Hashable
       
-        # Must be specified if type is `CATEGORICAL`.
-        # The list of possible categories.
+        # Must be specified if type is `CATEGORICAL`. The list of possible categories.
         # Corresponds to the JSON property `values`
         # @return [Array<String>]
         attr_accessor :values
@@ -207,11 +191,10 @@ module Google
       class GoogleCloudMlV1StudyConfigParameterSpecDiscreteValueSpec
         include Google::Apis::Core::Hashable
       
-        # Must be specified if type is `DISCRETE`.
-        # A list of feasible points.
-        # The list should be in strictly increasing order. For instance, this
-        # parameter might have possible settings of 1.5, 2.5, and 4.0. This list
-        # should not contain more than 1,000 values.
+        # Must be specified if type is `DISCRETE`. A list of feasible points. The list
+        # should be in strictly increasing order. For instance, this parameter might
+        # have possible settings of 1.5, 2.5, and 4.0. This list should not contain more
+        # than 1,000 values.
         # Corresponds to the JSON property `values`
         # @return [Array<Float>]
         attr_accessor :values
@@ -280,8 +263,8 @@ module Google
       class GoogleCloudMlV1StudyConfigParameterSpecMatchingParentCategoricalValueSpec
         include Google::Apis::Core::Hashable
       
-        # Matches values of the parent parameter with type 'CATEGORICAL'.
-        # All values must exist in `categorical_value_spec` of parent parameter.
+        # Matches values of the parent parameter with type 'CATEGORICAL'. All values
+        # must exist in `categorical_value_spec` of parent parameter.
         # Corresponds to the JSON property `values`
         # @return [Array<String>]
         attr_accessor :values
@@ -300,8 +283,8 @@ module Google
       class GoogleCloudMlV1StudyConfigParameterSpecMatchingParentDiscreteValueSpec
         include Google::Apis::Core::Hashable
       
-        # Matches values of the parent parameter with type 'DISCRETE'.
-        # All values must exist in `discrete_value_spec` of parent parameter.
+        # Matches values of the parent parameter with type 'DISCRETE'. All values must
+        # exist in `discrete_value_spec` of parent parameter.
         # Corresponds to the JSON property `values`
         # @return [Array<Float>]
         attr_accessor :values
@@ -320,8 +303,8 @@ module Google
       class GoogleCloudMlV1StudyConfigParameterSpecMatchingParentIntValueSpec
         include Google::Apis::Core::Hashable
       
-        # Matches values of the parent parameter with type 'INTEGER'.
-        # All values must lie in `integer_value_spec` of parent parameter.
+        # Matches values of the parent parameter with type 'INTEGER'. All values must
+        # lie in `integer_value_spec` of parent parameter.
         # Corresponds to the JSON property `values`
         # @return [Array<Fixnum>]
         attr_accessor :values
@@ -371,9 +354,8 @@ module Google
         attr_accessor :categorical_value_spec
       
         # A child node is active if the parameter's value matches the child node's
-        # matching_parent_values.
-        # If two items in child_parameter_specs have the same name, they must have
-        # disjoint matching_parent_values.
+        # matching_parent_values. If two items in child_parameter_specs have the same
+        # name, they must have disjoint matching_parent_values.
         # Corresponds to the JSON property `childParameterSpecs`
         # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpec>]
         attr_accessor :child_parameter_specs
@@ -413,8 +395,7 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpecMatchingParentIntValueSpec]
         attr_accessor :parent_int_values
       
-        # How the parameter should be scaled.
-        # Leave unset for categorical parameters.
+        # How the parameter should be scaled. Leave unset for categorical parameters.
         # Corresponds to the JSON property `scaleType`
         # @return [String]
         attr_accessor :scale_type
@@ -444,8 +425,8 @@ module Google
         end
       end
       
-      # A message representing a parameter to be tuned. Contains the name of
-      # the parameter and the suggested value to use for this trial.
+      # A message representing a parameter to be tuned. Contains the name of the
+      # parameter and the suggested value to use for this trial.
       class GoogleCloudMlV1TrialParameter
         include Google::Apis::Core::Hashable
       
@@ -482,11 +463,10 @@ module Google
         end
       end
       
-      # Represents a hardware accelerator request config.
-      # Note that the AcceleratorConfig can be used in both Jobs and Versions.
-      # Learn more about [accelerators for training](/ml-engine/docs/using-gpus) and
-      # [accelerators for online
-      # prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
+      # Represents a hardware accelerator request config. Note that the
+      # AcceleratorConfig can be used in both Jobs and Versions. Learn more about [
+      # accelerators for training](/ml-engine/docs/using-gpus) and [accelerators for
+      # online prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
       class GoogleCloudMlV1AcceleratorConfig
         include Google::Apis::Core::Hashable
       
@@ -534,48 +514,42 @@ module Google
       class GoogleCloudMlV1AutoScaling
         include Google::Apis::Core::Hashable
       
-        # Optional. The minimum number of nodes to allocate for this model. These
-        # nodes are always up, starting from the time the model is deployed.
-        # Therefore, the cost of operating this model will be at least
-        # `rate` * `min_nodes` * number of hours since last billing cycle,
-        # where `rate` is the cost per node-hour as documented in the
-        # [pricing guide](/ml-engine/docs/pricing),
-        # even if no predictions are performed. There is additional cost for each
-        # prediction performed.
-        # Unlike manual scaling, if the load gets too heavy for the nodes
-        # that are up, the service will automatically add nodes to handle the
-        # increased load as well as scale back as traffic drops, always maintaining
-        # at least `min_nodes`. You will be charged for the time in which additional
-        # nodes are used.
-        # If `min_nodes` is not specified and AutoScaling is used with a [legacy
-        # (MLS1) machine type](/ml-engine/docs/machine-types-online-prediction),
-        # `min_nodes` defaults to 0, in which case, when traffic to a model stops
-        # (and after a cool-down period), nodes will be shut down and no charges will
-        # be incurred until traffic to the model resumes.
-        # If `min_nodes` is not specified and AutoScaling is used with a [Compute
-        # Engine (N1) machine type](/ml-engine/docs/machine-types-online-prediction),
-        # `min_nodes` defaults to 1. `min_nodes` must be at least 1 for use with a
-        # Compute Engine machine type.
-        # Note that you cannot use AutoScaling if your version uses
-        # [GPUs](#Version.FIELDS.accelerator_config). Instead, you must use
-        # ManualScaling.
-        # You can set `min_nodes` when creating the model version, and you can also
-        # update `min_nodes` for an existing version:
-        # <pre>
-        # update_body.json:
-        # `
-        # 'autoScaling': `
-        # 'minNodes': 5
-        # `
-        # `
-        # </pre>
-        # HTTP request:
-        # <pre style="max-width: 626px;">
-        # PATCH
-        # https://ml.googleapis.com/v1/`name=projects/*/models/*/versions/*`?update_mask=
-        # autoScaling.minNodes
-        # -d @./update_body.json
-        # </pre>
+        # The maximum number of nodes to scale this model under load. The actual value
+        # will depend on resource quota and availability.
+        # Corresponds to the JSON property `maxNodes`
+        # @return [Fixnum]
+        attr_accessor :max_nodes
+      
+        # MetricSpec contains the specifications to use to calculate the desired nodes
+        # count.
+        # Corresponds to the JSON property `metrics`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1MetricSpec>]
+        attr_accessor :metrics
+      
+        # Optional. The minimum number of nodes to allocate for this model. These nodes
+        # are always up, starting from the time the model is deployed. Therefore, the
+        # cost of operating this model will be at least `rate` * `min_nodes` * number of
+        # hours since last billing cycle, where `rate` is the cost per node-hour as
+        # documented in the [pricing guide](/ml-engine/docs/pricing), even if no
+        # predictions are performed. There is additional cost for each prediction
+        # performed. Unlike manual scaling, if the load gets too heavy for the nodes
+        # that are up, the service will automatically add nodes to handle the increased
+        # load as well as scale back as traffic drops, always maintaining at least `
+        # min_nodes`. You will be charged for the time in which additional nodes are
+        # used. If `min_nodes` is not specified and AutoScaling is used with a [legacy (
+        # MLS1) machine type](/ml-engine/docs/machine-types-online-prediction), `
+        # min_nodes` defaults to 0, in which case, when traffic to a model stops (and
+        # after a cool-down period), nodes will be shut down and no charges will be
+        # incurred until traffic to the model resumes. If `min_nodes` is not specified
+        # and AutoScaling is used with a [Compute Engine (N1) machine type](/ml-engine/
+        # docs/machine-types-online-prediction), `min_nodes` defaults to 1. `min_nodes`
+        # must be at least 1 for use with a Compute Engine machine type. Note that you
+        # cannot use AutoScaling if your version uses [GPUs](#Version.FIELDS.
+        # accelerator_config). Instead, you must use ManualScaling. You can set `
+        # min_nodes` when creating the model version, and you can also update `min_nodes`
+        # for an existing version: update_body.json: ` 'autoScaling': ` 'minNodes': 5 `
+        # ` HTTP request: PATCH https://ml.googleapis.com/v1/`name=projects/*/models/*/
+        # versions/*`?update_mask=autoScaling.minNodes -d @./update_body.json
         # Corresponds to the JSON property `minNodes`
         # @return [Fixnum]
         attr_accessor :min_nodes
@@ -586,6 +560,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @max_nodes = args[:max_nodes] if args.key?(:max_nodes)
+          @metrics = args[:metrics] if args.key?(:metrics)
           @min_nodes = args[:min_nodes] if args.key?(:min_nodes)
         end
       end
@@ -600,11 +576,11 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1AutomatedStoppingConfigDecayCurveAutomatedStoppingConfig]
         attr_accessor :decay_curve_stopping_config
       
-        # The median automated stopping rule stops a pending trial if the trial's
-        # best objective_value is strictly below the median 'performance' of all
-        # completed trials reported up to the trial's last measurement.
-        # Currently, 'performance' refers to the running average of the objective
-        # values reported by the trial in each measurement.
+        # The median automated stopping rule stops a pending trial if the trial's best
+        # objective_value is strictly below the median 'performance' of all completed
+        # trials reported up to the trial's last measurement. Currently, 'performance'
+        # refers to the running average of the objective values reported by the trial in
+        # each measurement.
         # Corresponds to the JSON property `medianAutomatedStoppingConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1AutomatedStoppingConfigMedianAutomatedStoppingConfig]
         attr_accessor :median_automated_stopping_config
@@ -629,9 +605,9 @@ module Google
         # @return [String]
         attr_accessor :framework
       
-        # The Cloud Storage path to the `model/` directory where the training job
-        # saves the trained model. Only set for successful jobs that don't use
-        # hyperparameter tuning.
+        # The Cloud Storage path to the `model/` directory where the training job saves
+        # the trained model. Only set for successful jobs that don't use hyperparameter
+        # tuning.
         # Corresponds to the JSON property `modelPath`
         # @return [String]
         attr_accessor :model_path
@@ -641,8 +617,7 @@ module Google
         # @return [String]
         attr_accessor :python_version
       
-        # AI Platform runtime version on which the built-in algorithm was
-        # trained.
+        # AI Platform runtime version on which the built-in algorithm was trained.
         # Corresponds to the JSON property `runtimeVersion`
         # @return [String]
         attr_accessor :runtime_version
@@ -698,9 +673,8 @@ module Google
         end
       end
       
-      # This message will be placed in the metadata field of a
-      # google.longrunning.Operation associated with a CheckTrialEarlyStoppingState
-      # request.
+      # This message will be placed in the metadata field of a google.longrunning.
+      # Operation associated with a CheckTrialEarlyStoppingState request.
       class GoogleCloudMlV1CheckTrialEarlyStoppingStateMetatdata
         include Google::Apis::Core::Hashable
       
@@ -744,9 +718,8 @@ module Google
         end
       end
       
-      # The message will be placed in the response field of a completed
-      # google.longrunning.Operation associated with a CheckTrialEarlyStoppingState
-      # request.
+      # The message will be placed in the response field of a completed google.
+      # longrunning.Operation associated with a CheckTrialEarlyStoppingState request.
       class GoogleCloudMlV1CheckTrialEarlyStoppingStateResponse
         include Google::Apis::Core::Hashable
       
@@ -831,15 +804,171 @@ module Google
         end
       end
       
-      # Represents a custom encryption key configuration that can be applied to
-      # a resource.
+      # Represents a network port in a single container. This message is a subset of
+      # the [Kubernetes ContainerPort v1 core specification](https://kubernetes.io/
+      # docs/reference/generated/kubernetes-api/v1.18/#containerport-v1-core).
+      class GoogleCloudMlV1ContainerPort
+        include Google::Apis::Core::Hashable
+      
+        # Number of the port to expose on the container. This must be a valid port
+        # number: 0 < PORT_NUMBER < 65536.
+        # Corresponds to the JSON property `containerPort`
+        # @return [Fixnum]
+        attr_accessor :container_port
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @container_port = args[:container_port] if args.key?(:container_port)
+        end
+      end
+      
+      # Specification of a custom container for serving predictions. This message is a
+      # subset of the [Kubernetes Container v1 core specification](https://kubernetes.
+      # io/docs/reference/generated/kubernetes-api/v1.18/#container-v1-core).
+      class GoogleCloudMlV1ContainerSpec
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. Specifies arguments for the command that runs when the container
+        # starts. This overrides the container's [`CMD`](https://docs.docker.com/engine/
+        # reference/builder/#cmd). Specify this field as an array of executable and
+        # arguments, similar to a Docker `CMD`'s "default parameters" form. If you don't
+        # specify this field but do specify the command field, then the command from the
+        # `command` field runs without any additional arguments. See the [Kubernetes
+        # documentation about how the `command` and `args` fields interact with a
+        # container's `ENTRYPOINT` and `CMD`](https://kubernetes.io/docs/tasks/inject-
+        # data-application/define-command-argument-container/#notes). If you don't
+        # specify this field and don't specify the `commmand` field, then the container'
+        # s [`ENTRYPOINT`](https://docs.docker.com/engine/reference/builder/#cmd) and `
+        # CMD` determine what runs based on their default behavior. See the [Docker
+        # documentation about how `CMD` and `ENTRYPOINT` interact](https://docs.docker.
+        # com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). In
+        # this field, you can reference [environment variables set by AI Platform
+        # Prediction](/ai-platform/prediction/docs/custom-container-requirements#aip-
+        # variables) and environment variables set in the env field. You cannot
+        # reference environment variables set in the Docker image. In order for
+        # environment variables to be expanded, reference them by using the following
+        # syntax: $( VARIABLE_NAME) Note that this differs from Bash variable expansion,
+        # which does not use parentheses. If a variable cannot be resolved, the
+        # reference in the input string is used unchanged. To avoid variable expansion,
+        # you can escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This
+        # field corresponds to the `args` field of the [Kubernetes Containers v1 core
+        # API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#
+        # container-v1-core).
+        # Corresponds to the JSON property `args`
+        # @return [Array<String>]
+        attr_accessor :args
+      
+        # Immutable. Specifies the command that runs when the container starts. This
+        # overrides the container's [`ENTRYPOINT`](https://docs.docker.com/engine/
+        # reference/builder/#entrypoint). Specify this field as an array of executable
+        # and arguments, similar to a Docker `ENTRYPOINT`'s "exec" form, not its "shell"
+        # form. If you do not specify this field, then the container's `ENTRYPOINT` runs,
+        # in conjunction with the args field or the container's [`CMD`](https://docs.
+        # docker.com/engine/reference/builder/#cmd), if either exists. If this field is
+        # not specified and the container does not have an `ENTRYPOINT`, then refer to
+        # the [Docker documentation about how `CMD` and `ENTRYPOINT` interact](https://
+        # docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-
+        # interact). If you specify this field, then you can also specify the `args`
+        # field to provide additional arguments for this command. However, if you
+        # specify this field, then the container's `CMD` is ignored. See the [Kubernetes
+        # documentation about how the `command` and `args` fields interact with a
+        # container's `ENTRYPOINT` and `CMD`](https://kubernetes.io/docs/tasks/inject-
+        # data-application/define-command-argument-container/#notes). In this field, you
+        # can reference [environment variables set by AI Platform Prediction](/ai-
+        # platform/prediction/docs/custom-container-requirements#aip-variables) and
+        # environment variables set in the env field. You cannot reference environment
+        # variables set in the Docker image. In order for environment variables to be
+        # expanded, reference them by using the following syntax: $( VARIABLE_NAME) Note
+        # that this differs from Bash variable expansion, which does not use parentheses.
+        # If a variable cannot be resolved, the reference in the input string is used
+        # unchanged. To avoid variable expansion, you can escape this syntax with `$$`;
+        # for example: $$(VARIABLE_NAME) This field corresponds to the `command` field
+        # of the [Kubernetes Containers v1 core API](https://kubernetes.io/docs/
+        # reference/generated/kubernetes-api/v1.18/#container-v1-core).
+        # Corresponds to the JSON property `command`
+        # @return [Array<String>]
+        attr_accessor :command
+      
+        # Immutable. List of environment variables to set in the container. After the
+        # container starts running, code running in the container can read these
+        # environment variables. Additionally, the command and args fields can reference
+        # these variables. Later entries in this list can also reference earlier entries.
+        # For example, the following example sets the variable `VAR_2` to have the
+        # value `foo bar`: ```json [ ` "name": "VAR_1", "value": "foo" `, ` "name": "
+        # VAR_2", "value": "$(VAR_1) bar" ` ] ``` If you switch the order of the
+        # variables in the example, then the expansion does not occur. This field
+        # corresponds to the `env` field of the [Kubernetes Containers v1 core API](
+        # https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#container-
+        # v1-core).
+        # Corresponds to the JSON property `env`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1EnvVar>]
+        attr_accessor :env
+      
+        # URI of the Docker image to be used as the custom container for serving
+        # predictions. This URI must identify [an image in Artifact Registry](/artifact-
+        # registry/docs/overview) and begin with the hostname ``REGION`-docker.pkg.dev`,
+        # where ``REGION`` is replaced by the region that matches AI Platform Prediction
+        # [regional endpoint](/ai-platform/prediction/docs/regional-endpoints) that you
+        # are using. For example, if you are using the `us-central1-ml.googleapis.com`
+        # endpoint, then this URI must begin with `us-central1-docker.pkg.dev`. To use a
+        # custom container, the [AI Platform Google-managed service account](/ai-
+        # platform/prediction/docs/custom-service-account#default) must have permission
+        # to pull (read) the Docker image at this URI. The AI Platform Google-managed
+        # service account has the following format: `service-`PROJECT_NUMBER`@cloud-ml.
+        # google.com.iam.gserviceaccount.com` `PROJECT_NUMBER` is replaced by your
+        # Google Cloud project number. By default, this service account has necessary
+        # permissions to pull an Artifact Registry image in the same Google Cloud
+        # project where you are using AI Platform Prediction. In this case, no
+        # configuration is necessary. If you want to use an image from a different
+        # Google Cloud project, learn how to [grant the Artifact Registry Reader (roles/
+        # artifactregistry.reader) role for a repository](/artifact-registry/docs/access-
+        # control#grant-repo) to your projet's AI Platform Google-managed service
+        # account. To learn about the requirements for the Docker image itself, read [
+        # Custom container requirements](/ai-platform/prediction/docs/custom-container-
+        # requirements).
+        # Corresponds to the JSON property `image`
+        # @return [String]
+        attr_accessor :image
+      
+        # Immutable. List of ports to expose from the container. AI Platform Prediction
+        # sends any prediction requests that it receives to the first port on this list.
+        # AI Platform Prediction also sends [liveness and health checks](/ai-platform/
+        # prediction/docs/custom-container-requirements#health) to this port. If you do
+        # not specify this field, it defaults to following value: ```json [ ` "
+        # containerPort": 8080 ` ] ``` AI Platform Prediction does not use ports other
+        # than the first one listed. This field corresponds to the `ports` field of the [
+        # Kubernetes Containers v1 core API](https://kubernetes.io/docs/reference/
+        # generated/kubernetes-api/v1.18/#container-v1-core).
+        # Corresponds to the JSON property `ports`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1ContainerPort>]
+        attr_accessor :ports
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @args = args[:args] if args.key?(:args)
+          @command = args[:command] if args.key?(:command)
+          @env = args[:env] if args.key?(:env)
+          @image = args[:image] if args.key?(:image)
+          @ports = args[:ports] if args.key?(:ports)
+        end
+      end
+      
+      # Represents a custom encryption key configuration that can be applied to a
+      # resource.
       class GoogleCloudMlV1EncryptionConfig
         include Google::Apis::Core::Hashable
       
-        # The Cloud KMS resource identifier of the customer-managed encryption key
-        # used to protect a resource, such as a training job. It has the following
-        # format:
-        # `projects/`PROJECT_ID`/locations/`REGION`/keyRings/`KEY_RING_NAME`/cryptoKeys/`
+        # The Cloud KMS resource identifier of the customer-managed encryption key used
+        # to protect a resource, such as a training job. It has the following format: `
+        # projects/`PROJECT_ID`/locations/`REGION`/keyRings/`KEY_RING_NAME`/cryptoKeys/`
         # KEY_NAME``
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
@@ -855,39 +984,65 @@ module Google
         end
       end
       
+      # Represents an environment variable to be made available in a container. This
+      # message is a subset of the [Kubernetes EnvVar v1 core specification](https://
+      # kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#envvar-v1-core).
+      class GoogleCloudMlV1EnvVar
+        include Google::Apis::Core::Hashable
+      
+        # Name of the environment variable. Must be a [valid C identifier](https://
+        # github.com/kubernetes/kubernetes/blob/v1.18.8/staging/src/k8s.io/apimachinery/
+        # pkg/util/validation/validation.go#L258) and must not begin with the prefix `
+        # AIP_`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Value of the environment variable. Defaults to an empty string. In this field,
+        # you can reference [environment variables set by AI Platform Prediction](/ai-
+        # platform/prediction/docs/custom-container-requirements#aip-variables) and
+        # environment variables set earlier in the same env field as where this message
+        # occurs. You cannot reference environment variables set in the Docker image. In
+        # order for environment variables to be expanded, reference them by using the
+        # following syntax: $(VARIABLE_NAME) Note that this differs from Bash variable
+        # expansion, which does not use parentheses. If a variable cannot be resolved,
+        # the reference in the input string is used unchanged. To avoid variable
+        # expansion, you can escape this syntax with `$$`; for example: $$(VARIABLE_NAME)
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # Request for explanations to be issued against a trained model.
       class GoogleCloudMlV1ExplainRequest
         include Google::Apis::Core::Hashable
       
         # Message that represents an arbitrary HTTP body. It should only be used for
-        # payload formats that can't be represented as JSON, such as raw binary or
-        # an HTML page.
-        # This message can be used both in streaming and non-streaming API methods in
-        # the request as well as the response.
-        # It can be used as a top-level request field, which is convenient if one
-        # wants to extract parameters from either the URL or HTTP template into the
-        # request fields and also want access to the raw HTTP body.
-        # Example:
-        # message GetResourceRequest `
-        # // A unique request id.
-        # string request_id = 1;
-        # // The raw HTTP body is bound to this field.
-        # google.api.HttpBody http_body = 2;
-        # `
-        # service ResourceService `
-        # rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
-        # rpc UpdateResource(google.api.HttpBody) returns
-        # (google.protobuf.Empty);
-        # `
-        # Example with streaming methods:
-        # service CaldavService `
-        # rpc GetCalendar(stream google.api.HttpBody)
-        # returns (stream google.api.HttpBody);
-        # rpc UpdateCalendar(stream google.api.HttpBody)
-        # returns (stream google.api.HttpBody);
-        # `
-        # Use of this type only changes how the request and response bodies are
-        # handled, all other features will continue to work unchanged.
+        # payload formats that can't be represented as JSON, such as raw binary or an
+        # HTML page. This message can be used both in streaming and non-streaming API
+        # methods in the request as well as the response. It can be used as a top-level
+        # request field, which is convenient if one wants to extract parameters from
+        # either the URL or HTTP template into the request fields and also want access
+        # to the raw HTTP body. Example: message GetResourceRequest ` // A unique
+        # request id. string request_id = 1; // The raw HTTP body is bound to this field.
+        # google.api.HttpBody http_body = 2; ` service ResourceService ` rpc
+        # GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc
+        # UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); ` Example
+        # with streaming methods: service CaldavService ` rpc GetCalendar(stream google.
+        # api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream
+        # google.api.HttpBody) returns (stream google.api.HttpBody); ` Use of this type
+        # only changes how the request and response bodies are handled, all other
+        # features will continue to work unchanged.
         # Corresponds to the JSON property `httpBody`
         # @return [Google::Apis::MlV1::GoogleApiHttpBody]
         attr_accessor :http_body
@@ -902,17 +1057,16 @@ module Google
         end
       end
       
-      # Message holding configuration options for explaining model predictions.
-      # There are two feature attribution methods supported for TensorFlow models:
-      # integrated gradients and sampled Shapley.
-      # [Learn more about feature
+      # Message holding configuration options for explaining model predictions. There
+      # are three feature attribution methods supported for TensorFlow models:
+      # integrated gradients, sampled Shapley, and XRAI. [Learn more about feature
       # attributions.](/ai-platform/prediction/docs/ai-explanations/overview)
       class GoogleCloudMlV1ExplanationConfig
         include Google::Apis::Core::Hashable
       
-        # Attributes credit by computing the Aumann-Shapley value taking advantage
-        # of the model's fully differentiable structure. Refer to this paper for
-        # more details: https://arxiv.org/abs/1703.01365
+        # Attributes credit by computing the Aumann-Shapley value taking advantage of
+        # the model's fully differentiable structure. Refer to this paper for more
+        # details: https://arxiv.org/abs/1703.01365
         # Corresponds to the JSON property `integratedGradientsAttribution`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1IntegratedGradientsAttribution]
         attr_accessor :integrated_gradients_attribution
@@ -924,10 +1078,10 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1SampledShapleyAttribution]
         attr_accessor :sampled_shapley_attribution
       
-        # Attributes credit by computing the XRAI taking advantage
-        # of the model's fully differentiable structure. Refer to this paper for
-        # more details: https://arxiv.org/abs/1906.02825
-        # Currently only implemented for models with natural image inputs.
+        # Attributes credit by computing the XRAI taking advantage of the model's fully
+        # differentiable structure. Refer to this paper for more details: https://arxiv.
+        # org/abs/1906.02825 Currently only implemented for models with natural image
+        # inputs.
         # Corresponds to the JSON property `xraiAttribution`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1XraiAttribution]
         attr_accessor :xrai_attribution
@@ -975,10 +1129,10 @@ module Google
         end
       end
       
-      # Represents the result of a single hyperparameter tuning trial from a
-      # training job. The TrainingOutput object that is returned on successful
-      # completion of a training job with hyperparameter tuning includes a list
-      # of HyperparameterOutput objects, one for each successful trial.
+      # Represents the result of a single hyperparameter tuning trial from a training
+      # job. The TrainingOutput object that is returned on successful completion of a
+      # training job with hyperparameter tuning includes a list of
+      # HyperparameterOutput objects, one for each successful trial.
       class GoogleCloudMlV1HyperparameterOutput
         include Google::Apis::Core::Hashable
       
@@ -1051,61 +1205,55 @@ module Google
       class GoogleCloudMlV1HyperparameterSpec
         include Google::Apis::Core::Hashable
       
-        # Optional. The search algorithm specified for the hyperparameter
-        # tuning job.
-        # Uses the default AI Platform hyperparameter tuning
-        # algorithm if unspecified.
+        # Optional. The search algorithm specified for the hyperparameter tuning job.
+        # Uses the default AI Platform hyperparameter tuning algorithm if unspecified.
         # Corresponds to the JSON property `algorithm`
         # @return [String]
         attr_accessor :algorithm
       
-        # Optional. Indicates if the hyperparameter tuning job enables auto trial
-        # early stopping.
+        # Optional. Indicates if the hyperparameter tuning job enables auto trial early
+        # stopping.
         # Corresponds to the JSON property `enableTrialEarlyStopping`
         # @return [Boolean]
         attr_accessor :enable_trial_early_stopping
         alias_method :enable_trial_early_stopping?, :enable_trial_early_stopping
       
-        # Required. The type of goal to use for tuning. Available types are
-        # `MAXIMIZE` and `MINIMIZE`.
-        # Defaults to `MAXIMIZE`.
+        # Required. The type of goal to use for tuning. Available types are `MAXIMIZE`
+        # and `MINIMIZE`. Defaults to `MAXIMIZE`.
         # Corresponds to the JSON property `goal`
         # @return [String]
         attr_accessor :goal
       
         # Optional. The TensorFlow summary tag name to use for optimizing trials. For
         # current versions of TensorFlow, this tag name should exactly match what is
-        # shown in TensorBoard, including all scopes.  For versions of TensorFlow
-        # prior to 0.12, this should be only the tag passed to tf.Summary.
-        # By default, "training/hptuning/metric" will be used.
+        # shown in TensorBoard, including all scopes. For versions of TensorFlow prior
+        # to 0.12, this should be only the tag passed to tf.Summary. By default, "
+        # training/hptuning/metric" will be used.
         # Corresponds to the JSON property `hyperparameterMetricTag`
         # @return [String]
         attr_accessor :hyperparameter_metric_tag
       
-        # Optional. The number of failed trials that need to be seen before failing
-        # the hyperparameter tuning job. You can specify this field to override the
-        # default failing criteria for AI Platform hyperparameter tuning jobs.
-        # Defaults to zero, which means the service decides when a hyperparameter
-        # job should fail.
+        # Optional. The number of failed trials that need to be seen before failing the
+        # hyperparameter tuning job. You can specify this field to override the default
+        # failing criteria for AI Platform hyperparameter tuning jobs. Defaults to zero,
+        # which means the service decides when a hyperparameter job should fail.
         # Corresponds to the JSON property `maxFailedTrials`
         # @return [Fixnum]
         attr_accessor :max_failed_trials
       
-        # Optional. The number of training trials to run concurrently.
-        # You can reduce the time it takes to perform hyperparameter tuning by adding
-        # trials in parallel. However, each trail only benefits from the information
-        # gained in completed trials. That means that a trial does not get access to
-        # the results of trials running at the same time, which could reduce the
-        # quality of the overall optimization.
-        # Each trial will use the same scale tier and machine types.
-        # Defaults to one.
+        # Optional. The number of training trials to run concurrently. You can reduce
+        # the time it takes to perform hyperparameter tuning by adding trials in
+        # parallel. However, each trail only benefits from the information gained in
+        # completed trials. That means that a trial does not get access to the results
+        # of trials running at the same time, which could reduce the quality of the
+        # overall optimization. Each trial will use the same scale tier and machine
+        # types. Defaults to one.
         # Corresponds to the JSON property `maxParallelTrials`
         # @return [Fixnum]
         attr_accessor :max_parallel_trials
       
-        # Optional. How many training trials should be attempted to optimize
-        # the specified hyperparameters.
-        # Defaults to one.
+        # Optional. How many training trials should be attempted to optimize the
+        # specified hyperparameters. Defaults to one.
         # Corresponds to the JSON property `maxTrials`
         # @return [Fixnum]
         attr_accessor :max_trials
@@ -1115,9 +1263,9 @@ module Google
         # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1ParameterSpec>]
         attr_accessor :params
       
-        # Optional. The prior hyperparameter tuning job id that users hope to
-        # continue with. The job id will be used to find the corresponding vizier
-        # study guid and resume the study.
+        # Optional. The prior hyperparameter tuning job id that users hope to continue
+        # with. The job id will be used to find the corresponding vizier study guid and
+        # resume the study.
         # Corresponds to the JSON property `resumePreviousJobId`
         # @return [String]
         attr_accessor :resume_previous_job_id
@@ -1140,15 +1288,15 @@ module Google
         end
       end
       
-      # Attributes credit by computing the Aumann-Shapley value taking advantage
-      # of the model's fully differentiable structure. Refer to this paper for
-      # more details: https://arxiv.org/abs/1703.01365
+      # Attributes credit by computing the Aumann-Shapley value taking advantage of
+      # the model's fully differentiable structure. Refer to this paper for more
+      # details: https://arxiv.org/abs/1703.01365
       class GoogleCloudMlV1IntegratedGradientsAttribution
         include Google::Apis::Core::Hashable
       
-        # Number of steps for approximating the path integral.
-        # A good value to start is 50 and gradually increase until the
-        # sum to diff property is met within the desired error range.
+        # Number of steps for approximating the path integral. A good value to start is
+        # 50 and gradually increase until the sum to diff property is met within the
+        # desired error range.
         # Corresponds to the JSON property `numIntegralSteps`
         # @return [Fixnum]
         attr_accessor :num_integral_steps
@@ -1182,13 +1330,13 @@ module Google
         # @return [String]
         attr_accessor :error_message
       
-        # `etag` is used for optimistic concurrency control as a way to help
-        # prevent simultaneous updates of a job from overwriting each other.
-        # It is strongly suggested that systems make use of the `etag` in the
-        # read-modify-write cycle to perform job updates in order to avoid race
-        # conditions: An `etag` is returned in the response to `GetJob`, and
-        # systems are expected to put that etag in the request to `UpdateJob` to
-        # ensure that their change will be applied to the same version of the job.
+        # `etag` is used for optimistic concurrency control as a way to help prevent
+        # simultaneous updates of a job from overwriting each other. It is strongly
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
+        # to perform job updates in order to avoid race conditions: An `etag` is
+        # returned in the response to `GetJob`, and systems are expected to put that
+        # etag in the request to `UpdateJob` to ensure that their change will be applied
+        # to the same version of the job.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -1199,11 +1347,10 @@ module Google
         # @return [String]
         attr_accessor :job_id
       
-        # Optional. One or more labels that you can add, to organize your jobs.
-        # Each label is a key-value pair, where both the key and the value are
-        # arbitrary strings that you supply.
-        # For more information, see the documentation on
-        # <a href="/ml-engine/docs/tensorflow/resource-labels">using labels</a>.
+        # Optional. One or more labels that you can add, to organize your jobs. Each
+        # label is a key-value pair, where both the key and the value are arbitrary
+        # strings that you supply. For more information, see the documentation on using
+        # labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -1229,10 +1376,10 @@ module Google
         attr_accessor :state
       
         # Represents input parameters for a training job. When using the gcloud command
-        # to submit your training job, you can specify the input parameters as
-        # command-line arguments and/or in a YAML configuration file referenced from
-        # the --config command-line argument. For details, see the guide to [submitting
-        # a training job](/ai-platform/training/docs/training-jobs).
+        # to submit your training job, you can specify the input parameters as command-
+        # line arguments and/or in a YAML configuration file referenced from the --
+        # config command-line argument. For details, see the guide to [submitting a
+        # training job](/ai-platform/training/docs/training-jobs).
         # Corresponds to the JSON property `trainingInput`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1TrainingInput]
         attr_accessor :training_input
@@ -1435,9 +1582,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The number of nodes to allocate for this model. These nodes are always up,
-        # starting from the time the model is deployed, so the cost of operating
-        # this model will be proportional to `nodes` * number of hours since
-        # last billing cycle plus the cost for each prediction performed.
+        # starting from the time the model is deployed, so the cost of operating this
+        # model will be proportional to `nodes` * number of hours since last billing
+        # cycle plus the cost for each prediction performed.
         # Corresponds to the JSON property `nodes`
         # @return [Fixnum]
         attr_accessor :nodes
@@ -1456,20 +1603,19 @@ module Google
       class GoogleCloudMlV1Measurement
         include Google::Apis::Core::Hashable
       
-        # Output only. Time that the trial has been running at the point of
-        # this measurement.
+        # Output only. Time that the trial has been running at the point of this
+        # measurement.
         # Corresponds to the JSON property `elapsedTime`
         # @return [String]
         attr_accessor :elapsed_time
       
-        # Provides a list of metrics that act as inputs into the objective
-        # function.
+        # Provides a list of metrics that act as inputs into the objective function.
         # Corresponds to the JSON property `metrics`
         # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1MeasurementMetric>]
         attr_accessor :metrics
       
-        # The number of steps a machine learning model has been trained for.
-        # Must be non-negative.
+        # The number of steps a machine learning model has been trained for. Must be non-
+        # negative.
         # Corresponds to the JSON property `stepCount`
         # @return [Fixnum]
         attr_accessor :step_count
@@ -1486,18 +1632,43 @@ module Google
         end
       end
       
-      # Represents a machine learning solution.
-      # A model can have multiple versions, each of which is a deployed, trained
-      # model ready to receive prediction requests. The model itself is just a
-      # container.
+      # MetricSpec contains the specifications to use to calculate the desired nodes
+      # count when autoscaling is enabled.
+      class GoogleCloudMlV1MetricSpec
+        include Google::Apis::Core::Hashable
+      
+        # metric name.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Target specifies the target value for the given metric; once real metric
+        # deviates from the threshold by a certain percentage, the node count changes.
+        # Corresponds to the JSON property `target`
+        # @return [Fixnum]
+        attr_accessor :target
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @target = args[:target] if args.key?(:target)
+        end
+      end
+      
+      # Represents a machine learning solution. A model can have multiple versions,
+      # each of which is a deployed, trained model ready to receive prediction
+      # requests. The model itself is just a container.
       class GoogleCloudMlV1Model
         include Google::Apis::Core::Hashable
       
-        # Represents a version of the model.
-        # 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.
+        # Represents a version of the model. 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.
         # Corresponds to the JSON property `defaultVersion`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1Version]
         attr_accessor :default_version
@@ -1507,69 +1678,61 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # `etag` is used for optimistic concurrency control as a way to help
-        # prevent simultaneous updates of a model from overwriting each other.
-        # It is strongly suggested that systems make use of the `etag` in the
-        # read-modify-write cycle to perform model updates in order to avoid race
-        # conditions: An `etag` is returned in the response to `GetModel`, and
-        # systems are expected to put that etag in the request to `UpdateModel` to
-        # ensure that their change will be applied to the model as intended.
+        # `etag` is used for optimistic concurrency control as a way to help prevent
+        # simultaneous updates of a model from overwriting each other. It is strongly
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
+        # to perform model updates in order to avoid race conditions: An `etag` is
+        # returned in the response to `GetModel`, and systems are expected to put that
+        # etag in the request to `UpdateModel` to ensure that their change will be
+        # applied to the model as intended.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Optional. One or more labels that you can add, to organize your models.
-        # Each label is a key-value pair, where both the key and the value are
-        # arbitrary strings that you supply.
-        # For more information, see the documentation on
-        # <a href="/ml-engine/docs/tensorflow/resource-labels">using labels</a>.
+        # Optional. One or more labels that you can add, to organize your models. Each
+        # label is a key-value pair, where both the key and the value are arbitrary
+        # strings that you supply. For more information, see the documentation on using
+        # labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Required. The name specified for the model when it was created.
-        # The model name must be unique within the project it is created in.
+        # Required. The name specified for the model when it was created. The model name
+        # must be unique within the project it is created in.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Optional. If true, online prediction nodes send `stderr` and `stdout`
-        # streams to Stackdriver Logging. These can be more verbose than the standard
-        # access logs (see `onlinePredictionLogging`) and can incur higher cost.
-        # However, they are helpful for debugging. Note that
-        # [Stackdriver logs may incur a cost](/stackdriver/pricing), especially if
-        # your project receives prediction requests at a high QPS. Estimate your
-        # costs before enabling this option.
-        # Default is false.
+        # Optional. If true, online prediction nodes send `stderr` and `stdout` streams
+        # to Cloud Logging. These can be more verbose than the standard access logs (see
+        # `onlinePredictionLogging`) and can incur higher cost. However, they are
+        # helpful for debugging. Note that [logs may incur a cost](/stackdriver/pricing),
+        # especially if your project receives prediction requests at a high QPS.
+        # Estimate your costs before enabling this option. Default is false.
         # Corresponds to the JSON property `onlinePredictionConsoleLogging`
         # @return [Boolean]
         attr_accessor :online_prediction_console_logging
         alias_method :online_prediction_console_logging?, :online_prediction_console_logging
       
-        # Optional. If true, online prediction access logs are sent to StackDriver
-        # Logging. These logs are like standard server access logs, containing
-        # information like timestamp and latency for each request. Note that
-        # [Stackdriver logs may incur a cost](/stackdriver/pricing), especially if
-        # your project receives prediction requests at a high queries per second rate
-        # (QPS). Estimate your costs before enabling this option.
-        # Default is false.
+        # Optional. If true, online prediction access logs are sent to Cloud Logging.
+        # These logs are like standard server access logs, containing information like
+        # timestamp and latency for each request. Note that [logs may incur a cost](/
+        # stackdriver/pricing), especially if your project receives prediction requests
+        # at a high queries per second rate (QPS). Estimate your costs before enabling
+        # this option. Default is false.
         # Corresponds to the JSON property `onlinePredictionLogging`
         # @return [Boolean]
         attr_accessor :online_prediction_logging
         alias_method :online_prediction_logging?, :online_prediction_logging
       
-        # Optional. The list of regions where the model is going to be deployed.
-        # Only one region per model is supported.
-        # Defaults to 'us-central1' if nothing is set.
-        # See the <a href="/ml-engine/docs/tensorflow/regions">available regions</a>
-        # for AI Platform services.
-        # Note:
-        # *   No matter where a model is deployed, it can always be accessed by
-        # users from anywhere, both for online and batch prediction.
-        # *   The region for a batch prediction job is set by the region field when
-        # submitting the batch prediction job and does not take its value from
-        # this field.
+        # Optional. The list of regions where the model is going to be deployed. Only
+        # one region per model is supported. Defaults to 'us-central1' if nothing is set.
+        # See the available regions for AI Platform services. Note: * No matter where a
+        # model is deployed, it can always be accessed by users from anywhere, both for
+        # online and batch prediction. * The region for a batch prediction job is set by
+        # the region field when submitting the batch prediction job and does not take
+        # its value from this field.
         # Corresponds to the JSON property `regions`
         # @return [Array<String>]
         attr_accessor :regions
@@ -1611,8 +1774,8 @@ module Google
         attr_accessor :is_cancellation_requested
         alias_method :is_cancellation_requested?, :is_cancellation_requested
       
-        # The user labels, inherited from the model or the model version being
-        # operated on.
+        # The user labels, inherited from the model or the model version being operated
+        # on.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -1637,11 +1800,10 @@ module Google
         # @return [String]
         attr_accessor :start_time
       
-        # Represents a version of the model.
-        # 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.
+        # Represents a version of the model. 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.
         # Corresponds to the JSON property `version`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1Version]
         attr_accessor :version
@@ -1673,39 +1835,35 @@ module Google
         # @return [Array<String>]
         attr_accessor :categorical_values
       
-        # Required if type is `DISCRETE`.
-        # A list of feasible points.
-        # The list should be in strictly increasing order. For instance, this
-        # parameter might have possible settings of 1.5, 2.5, and 4.0. This list
-        # should not contain more than 1,000 values.
+        # Required if type is `DISCRETE`. A list of feasible points. The list should be
+        # in strictly increasing order. For instance, this parameter might have possible
+        # settings of 1.5, 2.5, and 4.0. This list should not contain more than 1,000
+        # values.
         # Corresponds to the JSON property `discreteValues`
         # @return [Array<Float>]
         attr_accessor :discrete_values
       
-        # Required if type is `DOUBLE` or `INTEGER`. This field
-        # should be unset if type is `CATEGORICAL`. This value should be integers if
-        # type is `INTEGER`.
+        # Required if type is `DOUBLE` or `INTEGER`. This field should be unset if type
+        # is `CATEGORICAL`. This value should be integers if type is `INTEGER`.
         # Corresponds to the JSON property `maxValue`
         # @return [Float]
         attr_accessor :max_value
       
-        # Required if type is `DOUBLE` or `INTEGER`. This field
-        # should be unset if type is `CATEGORICAL`. This value should be integers if
-        # type is INTEGER.
+        # Required if type is `DOUBLE` or `INTEGER`. This field should be unset if type
+        # is `CATEGORICAL`. This value should be integers if type is INTEGER.
         # Corresponds to the JSON property `minValue`
         # @return [Float]
         attr_accessor :min_value
       
-        # Required. The parameter name must be unique amongst all ParameterConfigs in
-        # a HyperparameterSpec message. E.g., "learning_rate".
+        # Required. The parameter name must be unique amongst all ParameterConfigs in a
+        # HyperparameterSpec message. E.g., "learning_rate".
         # Corresponds to the JSON property `parameterName`
         # @return [String]
         attr_accessor :parameter_name
       
-        # Optional. How the parameter should be scaled to the hypercube.
-        # Leave unset for categorical parameters.
-        # Some kind of scaling is strongly recommended for real or integral
-        # parameters (e.g., `UNIT_LINEAR_SCALE`).
+        # Optional. How the parameter should be scaled to the hypercube. Leave unset for
+        # categorical parameters. Some kind of scaling is strongly recommended for real
+        # or integral parameters (e.g., `UNIT_LINEAR_SCALE`).
         # Corresponds to the JSON property `scaleType`
         # @return [String]
         attr_accessor :scale_type
@@ -1736,34 +1894,21 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Message that represents an arbitrary HTTP body. It should only be used for
-        # payload formats that can't be represented as JSON, such as raw binary or
-        # an HTML page.
-        # This message can be used both in streaming and non-streaming API methods in
-        # the request as well as the response.
-        # It can be used as a top-level request field, which is convenient if one
-        # wants to extract parameters from either the URL or HTTP template into the
-        # request fields and also want access to the raw HTTP body.
-        # Example:
-        # message GetResourceRequest `
-        # // A unique request id.
-        # string request_id = 1;
-        # // The raw HTTP body is bound to this field.
-        # google.api.HttpBody http_body = 2;
-        # `
-        # service ResourceService `
-        # rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
-        # rpc UpdateResource(google.api.HttpBody) returns
-        # (google.protobuf.Empty);
-        # `
-        # Example with streaming methods:
-        # service CaldavService `
-        # rpc GetCalendar(stream google.api.HttpBody)
-        # returns (stream google.api.HttpBody);
-        # rpc UpdateCalendar(stream google.api.HttpBody)
-        # returns (stream google.api.HttpBody);
-        # `
-        # Use of this type only changes how the request and response bodies are
-        # handled, all other features will continue to work unchanged.
+        # payload formats that can't be represented as JSON, such as raw binary or an
+        # HTML page. This message can be used both in streaming and non-streaming API
+        # methods in the request as well as the response. It can be used as a top-level
+        # request field, which is convenient if one wants to extract parameters from
+        # either the URL or HTTP template into the request fields and also want access
+        # to the raw HTTP body. Example: message GetResourceRequest ` // A unique
+        # request id. string request_id = 1; // The raw HTTP body is bound to this field.
+        # google.api.HttpBody http_body = 2; ` service ResourceService ` rpc
+        # GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc
+        # UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); ` Example
+        # with streaming methods: service CaldavService ` rpc GetCalendar(stream google.
+        # api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream
+        # google.api.HttpBody) returns (stream google.api.HttpBody); ` Use of this type
+        # only changes how the request and response bodies are handled, all other
+        # features will continue to work unchanged.
         # Corresponds to the JSON property `httpBody`
         # @return [Google::Apis::MlV1::GoogleApiHttpBody]
         attr_accessor :http_body
@@ -1782,10 +1927,10 @@ module Google
       class GoogleCloudMlV1PredictionInput
         include Google::Apis::Core::Hashable
       
-        # Optional. Number of records per batch, defaults to 64.
-        # The service will buffer batch_size number of records in memory before
-        # invoking one Tensorflow prediction call internally. So take the record
-        # size and memory available into consideration when setting this parameter.
+        # Optional. Number of records per batch, defaults to 64. The service will buffer
+        # batch_size number of records in memory before invoking one Tensorflow
+        # prediction call internally. So take the record size and memory available into
+        # consideration when setting this parameter.
         # Corresponds to the JSON property `batchSize`
         # @return [Fixnum]
         attr_accessor :batch_size
@@ -1796,7 +1941,7 @@ module Google
         attr_accessor :data_format
       
         # Required. The Cloud Storage location of the input data files. May contain
-        # <a href="/storage/docs/gsutil/addlhelp/WildcardNames">wildcards</a>.
+        # wildcards.
         # Corresponds to the JSON property `inputPaths`
         # @return [Array<String>]
         attr_accessor :input_paths
@@ -1807,9 +1952,9 @@ module Google
         # @return [Fixnum]
         attr_accessor :max_worker_count
       
-        # Use this field if you want to use the default version for the specified
-        # model. The string must use the following format:
-        # `"projects/YOUR_PROJECT/models/YOUR_MODEL"`
+        # Use this field if you want to use the default version for the specified model.
+        # The string must use the following format: `"projects/YOUR_PROJECT/models/
+        # YOUR_MODEL"`
         # Corresponds to the JSON property `modelName`
         # @return [String]
         attr_accessor :model_name
@@ -1824,44 +1969,40 @@ module Google
         # @return [String]
         attr_accessor :output_path
       
-        # Required. The Google Compute Engine region to run the prediction job in.
-        # See the <a href="/ml-engine/docs/tensorflow/regions">available regions</a>
-        # for AI Platform services.
+        # Required. The Google Compute Engine region to run the prediction job in. See
+        # the available regions for AI Platform services.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
       
-        # Optional. The AI Platform runtime version to use for this batch
-        # prediction. If not set, AI Platform will pick the runtime version used
-        # during the CreateVersion request for this model version, or choose the
-        # latest stable version when model version information is not available
-        # such as when the model is specified by uri.
+        # Optional. The AI Platform runtime version to use for this batch prediction. If
+        # not set, AI Platform will pick the runtime version used during the
+        # CreateVersion request for this model version, or choose the latest stable
+        # version when model version information is not available such as when the model
+        # is specified by uri.
         # Corresponds to the JSON property `runtimeVersion`
         # @return [String]
         attr_accessor :runtime_version
       
-        # Optional. The name of the signature defined in the SavedModel to use for
-        # this job. Please refer to
-        # [SavedModel](https://tensorflow.github.io/serving/serving_basic.html)
-        # for information about how to use signatures.
-        # Defaults to
-        # [DEFAULT_SERVING_SIGNATURE_DEF_KEY](https://www.tensorflow.org/api_docs/python/
-        # tf/saved_model/signature_constants)
-        # , which is "serving_default".
+        # Optional. The name of the signature defined in the SavedModel to use for this
+        # job. Please refer to [SavedModel](https://tensorflow.github.io/serving/
+        # serving_basic.html) for information about how to use signatures. Defaults to [
+        # DEFAULT_SERVING_SIGNATURE_DEF_KEY](https://www.tensorflow.org/api_docs/python/
+        # tf/saved_model/signature_constants) , which is "serving_default".
         # Corresponds to the JSON property `signatureName`
         # @return [String]
         attr_accessor :signature_name
       
-        # Use this field if you want to specify a Google Cloud Storage path for
-        # the model to use.
+        # Use this field if you want to specify a Google Cloud Storage path for the
+        # model to use.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
       
         # Use this field if you want to specify a version of the model to use. The
-        # string is formatted the same way as `model_version`, with the addition
-        # of the version information:
-        # `"projects/YOUR_PROJECT/models/YOUR_MODEL/versions/YOUR_VERSION"`
+        # string is formatted the same way as `model_version`, with the addition of the
+        # version information: `"projects/YOUR_PROJECT/models/YOUR_MODEL/versions/
+        # YOUR_VERSION"`
         # Corresponds to the JSON property `versionName`
         # @return [String]
         attr_accessor :version_name
@@ -1928,68 +2069,56 @@ module Google
       class GoogleCloudMlV1ReplicaConfig
         include Google::Apis::Core::Hashable
       
-        # Represents a hardware accelerator request config.
-        # Note that the AcceleratorConfig can be used in both Jobs and Versions.
-        # Learn more about [accelerators for training](/ml-engine/docs/using-gpus) and
-        # [accelerators for online
-        # prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
+        # Represents a hardware accelerator request config. Note that the
+        # AcceleratorConfig can be used in both Jobs and Versions. Learn more about [
+        # accelerators for training](/ml-engine/docs/using-gpus) and [accelerators for
+        # online prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
         # Corresponds to the JSON property `acceleratorConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1AcceleratorConfig]
         attr_accessor :accelerator_config
       
-        # Arguments to the entrypoint command.
-        # The following rules apply for container_command and container_args:
-        # - If you do not supply command or args:
-        # The defaults defined in the Docker image are used.
-        # - If you supply a command but no args:
-        # The default EntryPoint and the default Cmd defined in the Docker image
-        # are ignored. Your command is run without any arguments.
-        # - If you supply only args:
-        # The default Entrypoint defined in the Docker image is run with the args
-        # that you supplied.
-        # - If you supply a command and args:
-        # The default Entrypoint and the default Cmd defined in the Docker image
-        # are ignored. Your command is run with your args.
-        # It cannot be set if custom container image is
-        # not provided.
-        # Note that this field and [TrainingInput.args] are mutually exclusive, i.e.,
-        # both cannot be set at the same time.
+        # Arguments to the entrypoint command. The following rules apply for
+        # container_command and container_args: - If you do not supply command or args:
+        # The defaults defined in the Docker image are used. - If you supply a command
+        # but no args: The default EntryPoint and the default Cmd defined in the Docker
+        # image are ignored. Your command is run without any arguments. - If you supply
+        # only args: The default Entrypoint defined in the Docker image is run with the
+        # args that you supplied. - If you supply a command and args: The default
+        # Entrypoint and the default Cmd defined in the Docker image are ignored. Your
+        # command is run with your args. It cannot be set if custom container image is
+        # not provided. Note that this field and [TrainingInput.args] are mutually
+        # exclusive, i.e., both cannot be set at the same time.
         # Corresponds to the JSON property `containerArgs`
         # @return [Array<String>]
         attr_accessor :container_args
       
-        # The command with which the replica's custom container is run.
-        # If provided, it will override default ENTRYPOINT of the docker image.
-        # If not provided, the docker image's ENTRYPOINT is used.
-        # It cannot be set if custom container image is
-        # not provided.
-        # Note that this field and [TrainingInput.args] are mutually exclusive, i.e.,
-        # both cannot be set at the same time.
+        # The command with which the replica's custom container is run. If provided, it
+        # will override default ENTRYPOINT of the docker image. If not provided, the
+        # docker image's ENTRYPOINT is used. It cannot be set if custom container image
+        # is not provided. Note that this field and [TrainingInput.args] are mutually
+        # exclusive, i.e., both cannot be set at the same time.
         # Corresponds to the JSON property `containerCommand`
         # @return [Array<String>]
         attr_accessor :container_command
       
         # The Docker image to run on the replica. This image must be in Container
-        # Registry. Learn more about [configuring custom
-        # containers](/ai-platform/training/docs/distributed-training-containers).
+        # Registry. Learn more about [configuring custom containers](/ai-platform/
+        # training/docs/distributed-training-containers).
         # Corresponds to the JSON property `imageUri`
         # @return [String]
         attr_accessor :image_uri
       
         # The AI Platform runtime version that includes a TensorFlow version matching
-        # the one used in the custom container. This field is required if the replica
-        # is a TPU worker that uses a custom container. Otherwise, do not specify
-        # this field. This must be a [runtime version that currently supports
-        # training with
-        # TPUs](/ml-engine/docs/tensorflow/runtime-version-list#tpu-support).
-        # Note that the version of TensorFlow included in a runtime version may
-        # differ from the numbering of the runtime version itself, because it may
-        # have a different [patch
-        # version](https://www.tensorflow.org/guide/version_compat#
-        # semantic_versioning_20).
-        # In this field, you must specify the runtime version (TensorFlow minor
-        # version). For example, if your custom container runs TensorFlow `1.x.y`,
-        # specify `1.x`.
+        # the one used in the custom container. This field is required if the replica is
+        # a TPU worker that uses a custom container. Otherwise, do not specify this
+        # field. This must be a [runtime version that currently supports training with
+        # TPUs](/ml-engine/docs/tensorflow/runtime-version-list#tpu-support). Note that
+        # the version of TensorFlow included in a runtime version may differ from the
+        # numbering of the runtime version itself, because it may have a different [
+        # patch version](https://www.tensorflow.org/guide/version_compat#
+        # semantic_versioning_20). In this field, you must specify the runtime version (
+        # TensorFlow minor version). For example, if your custom container runs
+        # TensorFlow `1.x.y`, specify `1.x`.
         # Corresponds to the JSON property `tpuTfVersion`
         # @return [String]
         attr_accessor :tpu_tf_version
@@ -2008,42 +2137,32 @@ module Google
         end
       end
       
-      # Configuration for logging request-response pairs to a BigQuery table.
-      # Online prediction requests to a model version and the responses to these
-      # requests are converted to raw strings and saved to the specified BigQuery
-      # table. Logging is constrained by [BigQuery quotas and
-      # limits](/bigquery/quotas). If your project exceeds BigQuery quotas or limits,
-      # AI Platform Prediction does not log request-response pairs, but it continues
-      # to serve predictions.
-      # If you are using [continuous
-      # evaluation](/ml-engine/docs/continuous-evaluation/), you do not need to
-      # specify this configuration manually. Setting up continuous evaluation
+      # Configuration for logging request-response pairs to a BigQuery table. Online
+      # prediction requests to a model version and the responses to these requests are
+      # converted to raw strings and saved to the specified BigQuery table. Logging is
+      # constrained by [BigQuery quotas and limits](/bigquery/quotas). If your project
+      # exceeds BigQuery quotas or limits, AI Platform Prediction does not log request-
+      # response pairs, but it continues to serve predictions. If you are using [
+      # continuous evaluation](/ml-engine/docs/continuous-evaluation/), you do not
+      # need to specify this configuration manually. Setting up continuous evaluation
       # automatically enables logging of request-response pairs.
       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 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>
-        # <tr><td>model</td><td>STRING</td><td>REQUIRED</td></tr>
-        # <tr><td>model_version</td><td>STRING</td><td>REQUIRED</td></tr>
-        # <tr><td>time</td><td>TIMESTAMP</td><td>REQUIRED</td></tr>
-        # <tr><td>raw_data</td><td>STRING</td><td>REQUIRED</td></tr>
-        # <tr><td>raw_prediction</td><td>STRING</td><td>NULLABLE</td></tr>
-        # <tr><td>groundtruth</td><td>STRING</td><td>NULLABLE</td></tr>
-        # </table>
+        # Required. Fully qualified BigQuery table name in the following format: "
+        # project_id.dataset_name.table_name" 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)
+        # : Field nameType Mode model STRING REQUIRED model_version STRING REQUIRED time
+        # TIMESTAMP REQUIRED raw_data STRING REQUIRED raw_prediction STRING NULLABLE
+        # groundtruth STRING NULLABLE
         # Corresponds to the JSON property `bigqueryTableName`
         # @return [String]
         attr_accessor :bigquery_table_name
       
-        # Percentage of requests to be logged, expressed as a fraction from 0 to 1.
-        # For example, if you want to log 10% of requests, enter `0.1`. The sampling
-        # window is the lifetime of the model version. Defaults to 0.
+        # Percentage of requests to be logged, expressed as a fraction from 0 to 1. For
+        # example, if you want to log 10% of requests, enter `0.1`. The sampling window
+        # is the lifetime of the model version. Defaults to 0.
         # Corresponds to the JSON property `samplingPercentage`
         # @return [Float]
         attr_accessor :sampling_percentage
@@ -2059,14 +2178,72 @@ module Google
         end
       end
       
+      # Specifies HTTP paths served by a custom container. AI Platform Prediction
+      # sends requests to these paths on the container; the custom container must run
+      # an HTTP server that responds to these requests with appropriate responses.
+      # Read [Custom container requirements](/ai-platform/prediction/docs/custom-
+      # container-requirements) for details on how to create your container image to
+      # meet these requirements.
+      class GoogleCloudMlV1RouteMap
+        include Google::Apis::Core::Hashable
+      
+        # HTTP path on the container to send health checkss to. AI Platform Prediction
+        # intermittently sends GET requests to this path on the container's IP address
+        # and port to check that the container is healthy. Read more about [health
+        # checks](/ai-platform/prediction/docs/custom-container-requirements#checks).
+        # For example, if you set this field to `/bar`, then AI Platform Prediction
+        # intermittently sends a GET request to the following URL on the container:
+        # localhost:PORT/bar PORT refers to the first value of Version.container.ports.
+        # If you don't specify this field, it defaults to the following value: /v1/
+        # models/MODEL/versions/VERSION The placeholders in this value are replaced as
+        # follows: * MODEL: The name of the parent Model. This does not include the "
+        # projects/PROJECT_ID/models/" prefix that the API returns in output; it is the
+        # bare model name, as provided to projects.models.create. * VERSION: The name of
+        # the model version. This does not include the "projects/PROJECT_ID/models/MODEL/
+        # versions/" prefix that the API returns in output; it is the bare version name,
+        # as provided to projects.models.versions.create.
+        # Corresponds to the JSON property `health`
+        # @return [String]
+        attr_accessor :health
+      
+        # HTTP path on the container to send prediction requests to. AI Platform
+        # Prediction forwards requests sent using projects.predict to this path on the
+        # container's IP address and port. AI Platform Prediction then returns the
+        # container's response in the API response. For example, if you set this field
+        # to `/foo`, then when AI Platform Prediction receives a prediction request, it
+        # forwards the request body in a POST request to the following URL on the
+        # container: localhost:PORT/foo PORT refers to the first value of Version.
+        # container.ports. If you don't specify this field, it defaults to the following
+        # value: /v1/models/MODEL/versions/VERSION:predict The placeholders in this
+        # value are replaced as follows: * MODEL: The name of the parent Model. This
+        # does not include the "projects/PROJECT_ID/models/" prefix that the API returns
+        # in output; it is the bare model name, as provided to projects.models.create. *
+        # VERSION: The name of the model version. This does not include the "projects/
+        # PROJECT_ID/models/MODEL/versions/" prefix that the API returns in output; it
+        # is the bare version name, as provided to projects.models.versions.create.
+        # Corresponds to the JSON property `predict`
+        # @return [String]
+        attr_accessor :predict
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @health = args[:health] if args.key?(:health)
+          @predict = args[:predict] if args.key?(:predict)
+        end
+      end
+      
       # An attribution method that approximates Shapley values for features that
       # contribute to the label being predicted. A sampling strategy is used to
       # 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.
+        # The number of feature permutations to consider when approximating the Shapley
+        # values.
         # Corresponds to the JSON property `numPaths`
         # @return [Fixnum]
         attr_accessor :num_paths
@@ -2087,29 +2264,40 @@ module Google
       
         # Optional. The maximum job running time, expressed in seconds. The field can
         # contain up to nine fractional digits, terminated by `s`. If not specified,
-        # this field defaults to `604800s` (seven days).
-        # 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
-        # ...
-        # ```
+        # this field defaults to `604800s` (seven days). If the training job is still
+        # running after this duration, AI Platform Training cancels it. The duration is
+        # measured from when the job enters the `RUNNING` state; therefore it does not
+        # overlap with the duration limited by Scheduling.max_wait_time. 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 [specify 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
       
-        # 
+        # Optional. The maximum job wait time, expressed in seconds. The field can
+        # contain up to nine fractional digits, terminated by `s`. If not specified,
+        # there is no limit to the wait time. The minimum for this field is `1800s` (30
+        # minutes). If the training job has not entered the `RUNNING` state after this
+        # duration, AI Platform Training cancels it. After the job begins running, it
+        # can no longer be cancelled due to the maximum wait time. Therefore the
+        # duration limited by this field does not overlap with the duration limited by
+        # Scheduling.max_running_time. For example, if the job temporarily stops running
+        # and retries due to a [VM restart](/ai-platform/training/docs/overview#restarts)
+        # , this cannot lead to a maximum wait time cancellation. However, independently
+        # of this constraint, AI Platform Training might stop a job if there are too
+        # many retries due to exhausted resources in a region. The following example
+        # describes how you might use this field: To cancel your job if it doesn't start
+        # running within 1 hour, set this field to `3600s` (1 hour * 60 minutes / hour *
+        # 60 seconds / minute). If the job is still in the `QUEUED` or `PREPARING` state
+        # after an hour of waiting, AI Platform Training cancels the job. If you submit
+        # your training job using the `gcloud` tool, you can [specify this field in a `
+        # config.yaml` file](/ai-platform/training/docs/training-jobs#
+        # formatting_your_configuration_parameters). For example: ```yaml trainingInput:
+        # scheduling: maxWaitTime: 3600s ```
         # Corresponds to the JSON property `maxWaitTime`
         # @return [String]
         attr_accessor :max_wait_time
@@ -2160,8 +2348,8 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # Output only. A human readable reason why the Study is inactive.
-        # This should be empty if a study is ACTIVE or COMPLETED.
+        # Output only. A human readable reason why the Study is inactive. This should be
+        # empty if a study is ACTIVE or COMPLETED.
         # Corresponds to the JSON property `inactiveReason`
         # @return [String]
         attr_accessor :inactive_reason
@@ -2233,8 +2421,8 @@ module Google
         end
       end
       
-      # Metadata field of a google.longrunning.Operation associated
-      # with a SuggestTrialsRequest.
+      # Metadata field of a google.longrunning.Operation associated with a
+      # SuggestTrialsRequest.
       class GoogleCloudMlV1SuggestTrialsMetadata
         include Google::Apis::Core::Hashable
       
@@ -2275,10 +2463,10 @@ module Google
       class GoogleCloudMlV1SuggestTrialsRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The identifier of the client that is requesting the suggestion.
-        # If multiple SuggestTrialsRequests have the same `client_id`,
-        # the service will return the identical suggested trial if the trial is
-        # pending, and provide a new trial if the last suggested trial was completed.
+        # Required. The identifier of the client that is requesting the suggestion. If
+        # multiple SuggestTrialsRequests have the same `client_id`, the service will
+        # return the identical suggested trial if the trial is pending, and provide a
+        # new trial if the last suggested trial was completed.
         # Corresponds to the JSON property `clientId`
         # @return [String]
         attr_accessor :client_id
@@ -2299,8 +2487,8 @@ module Google
         end
       end
       
-      # This message will be placed in the response field of a completed
-      # google.longrunning.Operation associated with a SuggestTrials request.
+      # This message will be placed in the response field of a completed google.
+      # longrunning.Operation associated with a SuggestTrials request.
       class GoogleCloudMlV1SuggestTrialsResponse
         include Google::Apis::Core::Hashable
       
@@ -2338,24 +2526,22 @@ module Google
       end
       
       # Represents input parameters for a training job. When using the gcloud command
-      # to submit your training job, you can specify the input parameters as
-      # command-line arguments and/or in a YAML configuration file referenced from
-      # the --config command-line argument. For details, see the guide to [submitting
-      # a training job](/ai-platform/training/docs/training-jobs).
+      # to submit your training job, you can specify the input parameters as command-
+      # line arguments and/or in a YAML configuration file referenced from the --
+      # config command-line argument. For details, see the guide to [submitting a
+      # training job](/ai-platform/training/docs/training-jobs).
       class GoogleCloudMlV1TrainingInput
         include Google::Apis::Core::Hashable
       
         # Optional. Command-line arguments passed to the training application when it
-        # starts. If your job uses a custom container, then the arguments are passed
-        # to the container's <a class="external" target="_blank"
-        # href="https://docs.docker.com/engine/reference/builder/#entrypoint">
-        # `ENTRYPOINT`</a> command.
+        # starts. If your job uses a custom container, then the arguments are passed to
+        # the container's `ENTRYPOINT` command.
         # Corresponds to the JSON property `args`
         # @return [Array<String>]
         attr_accessor :args
       
-        # Represents a custom encryption key configuration that can be applied to
-        # a resource.
+        # Represents a custom encryption key configuration that can be applied to a
+        # resource.
         # Corresponds to the JSON property `encryptionConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1EncryptionConfig]
         attr_accessor :encryption_config
@@ -2365,25 +2551,21 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1ReplicaConfig]
         attr_accessor :evaluator_config
       
-        # Optional. The number of evaluator replicas to use for the training job.
-        # Each replica in the cluster will be of the type specified in
-        # `evaluator_type`.
-        # This value can only be used when `scale_tier` is set to `CUSTOM`. If you
-        # set this value, you must also set `evaluator_type`.
-        # The default value is zero.
+        # Optional. The number of evaluator replicas to use for the training job. Each
+        # replica in the cluster will be of the type specified in `evaluator_type`. This
+        # value can only be used when `scale_tier` is set to `CUSTOM`. If you set this
+        # value, you must also set `evaluator_type`. The default value is zero.
         # Corresponds to the JSON property `evaluatorCount`
         # @return [Fixnum]
         attr_accessor :evaluator_count
       
-        # Optional. Specifies the type of virtual machine to use for your training
-        # job's evaluator nodes.
-        # The supported values are the same as those described in the entry for
-        # `masterType`.
-        # This value must be consistent with the category of machine type that
-        # `masterType` uses. In other words, both must be Compute Engine machine
-        # types or both must be legacy machine types.
-        # This value must be present when `scaleTier` is set to `CUSTOM` and
-        # `evaluatorCount` is greater than zero.
+        # Optional. Specifies the type of virtual machine to use for your training job's
+        # evaluator nodes. The supported values are the same as those described in the
+        # entry for `masterType`. This value must be consistent with the category of
+        # machine type that `masterType` uses. In other words, both must be Compute
+        # Engine machine types or both must be legacy machine types. This value must be
+        # present when `scaleTier` is set to `CUSTOM` and `evaluatorCount` is greater
+        # than zero.
         # Corresponds to the JSON property `evaluatorType`
         # @return [String]
         attr_accessor :evaluator_type
@@ -2393,10 +2575,10 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1HyperparameterSpec]
         attr_accessor :hyperparameters
       
-        # Optional. A Google Cloud Storage path in which to store training outputs
-        # and other data needed for training. This path is passed to your TensorFlow
-        # program as the '--job-dir' command-line argument. The benefit of specifying
-        # this field is that Cloud ML validates the path for use in training.
+        # Optional. A Google Cloud Storage path in which to store training outputs and
+        # other data needed for training. This path is passed to your TensorFlow program
+        # as the '--job-dir' command-line argument. The benefit of specifying this field
+        # is that Cloud ML validates the path for use in training.
         # Corresponds to the JSON property `jobDir`
         # @return [String]
         attr_accessor :job_dir
@@ -2406,71 +2588,42 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1ReplicaConfig]
         attr_accessor :master_config
       
-        # Optional. Specifies the type of virtual machine to use for your training
-        # job's master worker. You must specify this field when `scaleTier` is set to
-        # `CUSTOM`.
-        # You can use certain Compute Engine machine types directly in this field.
-        # The following types are supported:
-        # - `n1-standard-4`
-        # - `n1-standard-8`
-        # - `n1-standard-16`
-        # - `n1-standard-32`
-        # - `n1-standard-64`
-        # - `n1-standard-96`
-        # - `n1-highmem-2`
-        # - `n1-highmem-4`
-        # - `n1-highmem-8`
-        # - `n1-highmem-16`
-        # - `n1-highmem-32`
-        # - `n1-highmem-64`
-        # - `n1-highmem-96`
-        # - `n1-highcpu-16`
-        # - `n1-highcpu-32`
-        # - `n1-highcpu-64`
-        # - `n1-highcpu-96`
-        # Learn more about [using Compute Engine machine
-        # types](/ml-engine/docs/machine-types#compute-engine-machine-types).
-        # Alternatively, you can use the following legacy machine types:
-        # - `standard`
-        # - `large_model`
-        # - `complex_model_s`
-        # - `complex_model_m`
-        # - `complex_model_l`
-        # - `standard_gpu`
-        # - `complex_model_m_gpu`
-        # - `complex_model_l_gpu`
-        # - `standard_p100`
-        # - `complex_model_m_p100`
-        # - `standard_v100`
-        # - `large_model_v100`
-        # - `complex_model_m_v100`
-        # - `complex_model_l_v100`
-        # Learn more about [using legacy machine
-        # types](/ml-engine/docs/machine-types#legacy-machine-types).
-        # Finally, if you want to use a TPU for training, specify `cloud_tpu` in this
-        # field. Learn more about the [special configuration options for training
-        # with
-        # TPUs](/ml-engine/docs/tensorflow/using-tpus#configuring_a_custom_tpu_machine).
+        # Optional. Specifies the type of virtual machine to use for your training job's
+        # master worker. You must specify this field when `scaleTier` is set to `CUSTOM`.
+        # You can use certain Compute Engine machine types directly in this field. The
+        # following types are supported: - `n1-standard-4` - `n1-standard-8` - `n1-
+        # standard-16` - `n1-standard-32` - `n1-standard-64` - `n1-standard-96` - `n1-
+        # highmem-2` - `n1-highmem-4` - `n1-highmem-8` - `n1-highmem-16` - `n1-highmem-
+        # 32` - `n1-highmem-64` - `n1-highmem-96` - `n1-highcpu-16` - `n1-highcpu-32` - `
+        # n1-highcpu-64` - `n1-highcpu-96` Learn more about [using Compute Engine
+        # machine types](/ml-engine/docs/machine-types#compute-engine-machine-types).
+        # Alternatively, you can use the following legacy machine types: - `standard` - `
+        # large_model` - `complex_model_s` - `complex_model_m` - `complex_model_l` - `
+        # standard_gpu` - `complex_model_m_gpu` - `complex_model_l_gpu` - `standard_p100`
+        # - `complex_model_m_p100` - `standard_v100` - `large_model_v100` - `
+        # complex_model_m_v100` - `complex_model_l_v100` Learn more about [using legacy
+        # machine types](/ml-engine/docs/machine-types#legacy-machine-types). Finally,
+        # if you want to use a TPU for training, specify `cloud_tpu` in this field.
+        # Learn more about the [special configuration options for training with TPUs](/
+        # ml-engine/docs/tensorflow/using-tpus#configuring_a_custom_tpu_machine).
         # Corresponds to the JSON property `masterType`
         # @return [String]
         attr_accessor :master_type
       
         # Optional. The full name of the [Compute Engine network](/vpc/docs/vpc) to
-        # which the
-        # Job is peered. For example, `projects/12345/global/networks/myVPC`. The
-        # format of this field is `projects/`project`/global/networks/`network``,
+        # which the Job is peered. For example, `projects/12345/global/networks/myVPC`.
+        # The format of this field is `projects/`project`/global/networks/`network``,
         # where `project` is a project number (like `12345`) and `network` is network
-        # name.
-        # Private services access must already be configured for the network. If left
-        # unspecified, the Job is not peered with any network. [Learn about using VPC
-        # Network Peering.](/ai-platform/training/docs/vpc-peering).
+        # name. Private services access must already be configured for the network. If
+        # left unspecified, the Job is not peered with any network. [Learn about using
+        # VPC Network Peering.](/ai-platform/training/docs/vpc-peering).
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
       
-        # Required. The Google Cloud Storage location of the packages with
-        # the training program and any additional dependencies.
-        # The maximum number of package URIs is 100.
+        # Required. The Google Cloud Storage location of the packages with the training
+        # program and any additional dependencies. The maximum number of package URIs is
+        # 100.
         # Corresponds to the JSON property `packageUris`
         # @return [Array<String>]
         attr_accessor :package_uris
@@ -2480,25 +2633,22 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1ReplicaConfig]
         attr_accessor :parameter_server_config
       
-        # Optional. The number of parameter server replicas to use for the training
-        # job. Each replica in the cluster will be of the type specified in
-        # `parameter_server_type`.
-        # This value can only be used when `scale_tier` is set to `CUSTOM`. If you
-        # set this value, you must also set `parameter_server_type`.
+        # Optional. The number of parameter server replicas to use for the training job.
+        # Each replica in the cluster will be of the type specified in `
+        # parameter_server_type`. This value can only be used when `scale_tier` is set
+        # to `CUSTOM`. If you set this value, you must also set `parameter_server_type`.
         # The default value is zero.
         # Corresponds to the JSON property `parameterServerCount`
         # @return [Fixnum]
         attr_accessor :parameter_server_count
       
-        # Optional. Specifies the type of virtual machine to use for your training
-        # job's parameter server.
-        # The supported values are the same as those described in the entry for
-        # `master_type`.
-        # This value must be consistent with the category of machine type that
-        # `masterType` uses. In other words, both must be Compute Engine machine
-        # types or both must be legacy machine types.
-        # This value must be present when `scaleTier` is set to `CUSTOM` and
-        # `parameter_server_count` is greater than zero.
+        # Optional. Specifies the type of virtual machine to use for your training job's
+        # parameter server. The supported values are the same as those described in the
+        # entry for `master_type`. This value must be consistent with the category of
+        # machine type that `masterType` uses. In other words, both must be Compute
+        # Engine machine types or both must be legacy machine types. This value must be
+        # present when `scaleTier` is set to `CUSTOM` and `parameter_server_count` is
+        # greater than zero.
         # Corresponds to the JSON property `parameterServerType`
         # @return [String]
         attr_accessor :parameter_server_type
@@ -2508,38 +2658,35 @@ module Google
         # @return [String]
         attr_accessor :python_module
       
-        # Optional. The version of Python used in training. You must either specify
-        # this field or specify `masterConfig.imageUri`.
-        # 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.
-        # Read more about the Python versions available for [each runtime
-        # version](/ml-engine/docs/runtime-version-list).
+        # Optional. The version of Python used in training. You must either specify this
+        # field or specify `masterConfig.imageUri`. 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. 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 region to run the training job in. See the [available
-        # regions](/ai-platform/training/docs/regions) for AI Platform Training.
+        # Required. The region to run the training job in. See the [available regions](/
+        # ai-platform/training/docs/regions) for AI Platform Training.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
       
-        # Optional. The AI Platform runtime version to use for training. You must
-        # either specify this field or specify `masterConfig.imageUri`.
-        # For more information, see the [runtime version
-        # list](/ai-platform/training/docs/runtime-version-list) and learn [how to
-        # manage runtime versions](/ai-platform/training/docs/versioning).
+        # Optional. The AI Platform runtime version to use for training. You must either
+        # specify this field or specify `masterConfig.imageUri`. For more information,
+        # see the [runtime version list](/ai-platform/training/docs/runtime-version-list)
+        # and learn [how to manage runtime versions](/ai-platform/training/docs/
+        # versioning).
         # Corresponds to the JSON property `runtimeVersion`
         # @return [String]
         attr_accessor :runtime_version
       
-        # Required. Specifies the machine types, the number of replicas for workers
-        # and parameter servers.
+        # Required. Specifies the machine types, the number of replicas for workers and
+        # parameter servers.
         # Corresponds to the JSON property `scaleTier`
         # @return [String]
         attr_accessor :scale_tier
@@ -2552,23 +2699,20 @@ module Google
         # Optional. The email address of a service account to use when running the
         # training appplication. You must have the `iam.serviceAccounts.actAs`
         # permission for the specified service account. In addition, the AI Platform
-        # Training Google-managed service account must have the
-        # `roles/iam.serviceAccountAdmin` role for the specified service account.
-        # [Learn more about configuring a service
-        # account.](/ai-platform/training/docs/custom-service-account)
-        # If not specified, the AI Platform Training Google-managed service account
-        # is used by default.
+        # Training Google-managed service account must have the `roles/iam.
+        # serviceAccountAdmin` role for the specified service account. [Learn more about
+        # configuring a service account.](/ai-platform/training/docs/custom-service-
+        # account) If not specified, the AI Platform Training Google-managed service
+        # account is used by default.
         # Corresponds to the JSON property `serviceAccount`
         # @return [String]
         attr_accessor :service_account
       
         # Optional. Use `chief` instead of `master` in the `TF_CONFIG` environment
         # variable when training with a custom container. Defaults to `false`. [Learn
-        # more about this
-        # field.](/ai-platform/training/docs/distributed-training-details#chief-versus-
-        # master)
-        # This field has no effect for training jobs that don't use a custom
-        # container.
+        # more about this field.](/ai-platform/training/docs/distributed-training-
+        # details#chief-versus-master) This field has no effect for training jobs that
+        # don't use a custom container.
         # Corresponds to the JSON property `useChiefInTfConfig`
         # @return [Boolean]
         attr_accessor :use_chief_in_tf_config
@@ -2580,27 +2724,22 @@ module Google
         attr_accessor :worker_config
       
         # Optional. The number of worker replicas to use for the training job. Each
-        # replica in the cluster will be of the type specified in `worker_type`.
-        # This value can only be used when `scale_tier` is set to `CUSTOM`. If you
-        # set this value, you must also set `worker_type`.
-        # The default value is zero.
+        # replica in the cluster will be of the type specified in `worker_type`. This
+        # value can only be used when `scale_tier` is set to `CUSTOM`. If you set this
+        # value, you must also set `worker_type`. The default value is zero.
         # Corresponds to the JSON property `workerCount`
         # @return [Fixnum]
         attr_accessor :worker_count
       
-        # Optional. Specifies the type of virtual machine to use for your training
-        # job's worker nodes.
-        # The supported values are the same as those described in the entry for
-        # `masterType`.
-        # This value must be consistent with the category of machine type that
-        # `masterType` uses. In other words, both must be Compute Engine machine
-        # types or both must be legacy machine types.
-        # If you use `cloud_tpu` for this value, see special instructions for
-        # [configuring a custom TPU
-        # machine](/ml-engine/docs/tensorflow/using-tpus#
-        # configuring_a_custom_tpu_machine).
-        # This value must be present when `scaleTier` is set to `CUSTOM` and
-        # `workerCount` is greater than zero.
+        # Optional. Specifies the type of virtual machine to use for your training job's
+        # worker nodes. The supported values are the same as those described in the
+        # entry for `masterType`. This value must be consistent with the category of
+        # machine type that `masterType` uses. In other words, both must be Compute
+        # Engine machine types or both must be legacy machine types. If you use `
+        # cloud_tpu` for this value, see special instructions for [configuring a custom
+        # TPU machine](/ml-engine/docs/tensorflow/using-tpus#
+        # configuring_a_custom_tpu_machine). This value must be present when `scaleTier`
+        # is set to `CUSTOM` and `workerCount` is greater than zero.
         # Corresponds to the JSON property `workerType`
         # @return [String]
         attr_accessor :worker_type
@@ -2648,8 +2787,8 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1BuiltInAlgorithmOutput]
         attr_accessor :built_in_algorithm_output
       
-        # The number of hyperparameter tuning trials that completed successfully.
-        # Only set for hyperparameter tuning jobs.
+        # The number of hyperparameter tuning trials that completed successfully. Only
+        # set for hyperparameter tuning jobs.
         # Corresponds to the JSON property `completedTrialCount`
         # @return [Fixnum]
         attr_accessor :completed_trial_count
@@ -2660,10 +2799,9 @@ module Google
         attr_accessor :consumed_ml_units
       
         # The TensorFlow summary tag name used for optimizing hyperparameter tuning
-        # trials. See
-        # [`HyperparameterSpec.hyperparameterMetricTag`](#HyperparameterSpec.FIELDS.
-        # hyperparameter_metric_tag)
-        # for more information. Only set for hyperparameter tuning jobs.
+        # trials. See [`HyperparameterSpec.hyperparameterMetricTag`](#HyperparameterSpec.
+        # FIELDS.hyperparameter_metric_tag) for more information. Only set for
+        # hyperparameter tuning jobs.
         # Corresponds to the JSON property `hyperparameterMetricTag`
         # @return [String]
         attr_accessor :hyperparameter_metric_tag
@@ -2680,8 +2818,8 @@ module Google
         attr_accessor :is_hyperparameter_tuning_job
         alias_method :is_hyperparameter_tuning_job?, :is_hyperparameter_tuning_job
       
-        # Results for individual Hyperparameter trials.
-        # Only set for hyperparameter tuning jobs.
+        # Results for individual Hyperparameter trials. Only set for hyperparameter
+        # tuning jobs.
         # Corresponds to the JSON property `trials`
         # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1HyperparameterOutput>]
         attr_accessor :trials
@@ -2721,15 +2859,15 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1Measurement]
         attr_accessor :final_measurement
       
-        # Output only. A human readable string describing why the trial is
-        # infeasible. This should only be set if trial_infeasible is true.
+        # Output only. A human readable string describing why the trial is infeasible.
+        # This should only be set if trial_infeasible is true.
         # Corresponds to the JSON property `infeasibleReason`
         # @return [String]
         attr_accessor :infeasible_reason
       
-        # A list of measurements that are strictly lexicographically
-        # ordered by their induced tuples (steps, elapsed_time).
-        # These are used for early stopping computations.
+        # A list of measurements that are strictly lexicographically ordered by their
+        # induced tuples (steps, elapsed_time). These are used for early stopping
+        # computations.
         # Corresponds to the JSON property `measurements`
         # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1Measurement>]
         attr_accessor :measurements
@@ -2779,19 +2917,17 @@ module Google
         end
       end
       
-      # Represents a version of the model.
-      # 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.
+      # Represents a version of the model. 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.
       class GoogleCloudMlV1Version
         include Google::Apis::Core::Hashable
       
-        # Represents a hardware accelerator request config.
-        # Note that the AcceleratorConfig can be used in both Jobs and Versions.
-        # Learn more about [accelerators for training](/ml-engine/docs/using-gpus) and
-        # [accelerators for online
-        # prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
+        # Represents a hardware accelerator request config. Note that the
+        # AcceleratorConfig can be used in both Jobs and Versions. Learn more about [
+        # accelerators for training](/ml-engine/docs/using-gpus) and [accelerators for
+        # online prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
         # Corresponds to the JSON property `acceleratorConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1AcceleratorConfig]
         attr_accessor :accelerator_config
@@ -2801,22 +2937,30 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1AutoScaling]
         attr_accessor :auto_scaling
       
+        # Specification of a custom container for serving predictions. This message is a
+        # subset of the [Kubernetes Container v1 core specification](https://kubernetes.
+        # io/docs/reference/generated/kubernetes-api/v1.18/#container-v1-core).
+        # Corresponds to the JSON property `container`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1ContainerSpec]
+        attr_accessor :container
+      
         # Output only. The time the version was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # Required. The Cloud Storage location of the trained model used to
-        # create the version. See the
-        # [guide to model
-        # deployment](/ml-engine/docs/tensorflow/deploying-models) for more
-        # information.
-        # When passing Version to
-        # 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.
-        # The total number of model files can't exceed 1000.
+        # The Cloud Storage URI of a directory containing trained model artifacts to be
+        # used to create the model version. See the [guide to deploying models](/ai-
+        # platform/prediction/docs/deploying-models) for more information. The total
+        # number of files under this directory must not exceed 1000. During projects.
+        # models.versions.create, AI Platform Prediction copies all files from the
+        # specified directory to a location managed by the service. From then on, AI
+        # Platform Prediction uses these copies of the model artifacts to serve
+        # predictions, not the original files in Cloud Storage, so this location is
+        # useful only as a historical record. If you specify container, then this field
+        # is optional. Otherwise, it is required. Learn [how to use this field with a
+        # custom container](/ai-platform/prediction/docs/custom-container-requirements#
+        # artifacts).
         # Corresponds to the JSON property `deploymentUri`
         # @return [String]
         attr_accessor :deployment_uri
@@ -2831,57 +2975,50 @@ module Google
         # @return [String]
         attr_accessor :error_message
       
-        # `etag` is used for optimistic concurrency control as a way to help
-        # prevent simultaneous updates of a model from overwriting each other.
-        # It is strongly suggested that systems make use of the `etag` in the
-        # read-modify-write cycle to perform model updates in order to avoid race
-        # conditions: An `etag` is returned in the response to `GetVersion`, and
-        # systems are expected to put that etag in the request to `UpdateVersion` to
-        # ensure that their change will be applied to the model as intended.
+        # `etag` is used for optimistic concurrency control as a way to help prevent
+        # simultaneous updates of a model from overwriting each other. It is strongly
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
+        # to perform model updates in order to avoid race conditions: An `etag` is
+        # returned in the response to `GetVersion`, and systems are expected to put that
+        # etag in the request to `UpdateVersion` to ensure that their change will be
+        # applied to the model as intended.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Message holding configuration options for explaining model predictions.
-        # There are two feature attribution methods supported for TensorFlow models:
-        # integrated gradients and sampled Shapley.
-        # [Learn more about feature
+        # Message holding configuration options for explaining model predictions. There
+        # are three feature attribution methods supported for TensorFlow models:
+        # integrated gradients, sampled Shapley, and XRAI. [Learn more about feature
         # attributions.](/ai-platform/prediction/docs/ai-explanations/overview)
         # Corresponds to the JSON property `explanationConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1ExplanationConfig]
         attr_accessor :explanation_config
       
-        # Optional. The machine learning framework AI Platform uses to train
-        # this version of the model. Valid values are `TENSORFLOW`, `SCIKIT_LEARN`,
-        # `XGBOOST`. If you do not specify a framework, AI Platform
-        # will analyze files in the deployment_uri to determine a framework. If you
-        # choose `SCIKIT_LEARN` or `XGBOOST`, you must also set the runtime version
-        # of the model to 1.4 or greater.
-        # Do **not** specify a framework if you're deploying a [custom
-        # prediction routine](/ml-engine/docs/tensorflow/custom-prediction-routines).
-        # If you specify a [Compute Engine (N1) machine
-        # type](/ml-engine/docs/machine-types-online-prediction) in the
-        # `machineType` field, you must specify `TENSORFLOW`
-        # for the framework.
+        # Optional. The machine learning framework AI Platform uses to train this
+        # version of the model. Valid values are `TENSORFLOW`, `SCIKIT_LEARN`, `XGBOOST`.
+        # If you do not specify a framework, AI Platform will analyze files in the
+        # deployment_uri to determine a framework. If you choose `SCIKIT_LEARN` or `
+        # XGBOOST`, you must also set the runtime version of the model to 1.4 or greater.
+        # Do **not** specify a framework if you're deploying a [custom prediction
+        # routine](/ai-platform/prediction/docs/custom-prediction-routines) or if you're
+        # using a [custom container](/ai-platform/prediction/docs/use-custom-container).
         # Corresponds to the JSON property `framework`
         # @return [String]
         attr_accessor :framework
       
-        # 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
+        # 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.
         # Corresponds to the JSON property `isDefault`
         # @return [Boolean]
         attr_accessor :is_default
         alias_method :is_default?, :is_default
       
-        # Optional. One or more labels that you can add, to organize your model
-        # versions. Each label is a key-value pair, where both the key and the value
-        # are arbitrary strings that you supply.
-        # For more information, see the documentation on
-        # <a href="/ml-engine/docs/tensorflow/resource-labels">using labels</a>.
+        # Optional. One or more labels that you can add, to organize your model versions.
+        # Each label is a key-value pair, where both the key and the value are
+        # arbitrary strings that you supply. For more information, see the documentation
+        # on using labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -2893,28 +3030,14 @@ module Google
       
         # Optional. The type of machine on which to serve the model. Currently only
         # applies to online prediction service. If this field is not specified, it
-        # defaults to `mls1-c1-m2`.
-        # Online prediction supports the following machine types:
-        # * `mls1-c1-m2`
-        # * `mls1-c4-m2`
-        # * `n1-standard-2`
-        # * `n1-standard-4`
-        # * `n1-standard-8`
-        # * `n1-standard-16`
-        # * `n1-standard-32`
-        # * `n1-highmem-2`
-        # * `n1-highmem-4`
-        # * `n1-highmem-8`
-        # * `n1-highmem-16`
-        # * `n1-highmem-32`
-        # * `n1-highcpu-2`
-        # * `n1-highcpu-4`
-        # * `n1-highcpu-8`
-        # * `n1-highcpu-16`
-        # * `n1-highcpu-32`
-        # `mls1-c1-m2` is generally available. All other machine types are available
-        # in beta. Learn more about the [differences between machine
-        # types](/ml-engine/docs/machine-types-online-prediction).
+        # defaults to `mls1-c1-m2`. Online prediction supports the following machine
+        # types: * `mls1-c1-m2` * `mls1-c4-m2` * `n1-standard-2` * `n1-standard-4` * `n1-
+        # standard-8` * `n1-standard-16` * `n1-standard-32` * `n1-highmem-2` * `n1-
+        # highmem-4` * `n1-highmem-8` * `n1-highmem-16` * `n1-highmem-32` * `n1-highcpu-
+        # 2` * `n1-highcpu-4` * `n1-highcpu-8` * `n1-highcpu-16` * `n1-highcpu-32` `mls1-
+        # c4-m2` is in beta. All other machine types are generally available. Learn more
+        # about the [differences between machine types](/ml-engine/docs/machine-types-
+        # online-prediction).
         # Corresponds to the JSON property `machineType`
         # @return [String]
         attr_accessor :machine_type
@@ -2924,113 +3047,99 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1ManualScaling]
         attr_accessor :manual_scaling
       
-        # Required. The name specified for the version when it was created.
-        # The version name must be unique within the model it is created in.
+        # Required. The name specified for the version when it was created. The version
+        # name must be unique within the model it is created in.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Optional. Cloud Storage paths (`gs://…`) of packages for [custom
-        # prediction routines](/ml-engine/docs/tensorflow/custom-prediction-routines)
-        # or [scikit-learn pipelines with custom
-        # code](/ml-engine/docs/scikit/exporting-for-prediction#custom-pipeline-code).
-        # For a custom prediction routine, one of these packages must contain your
-        # Predictor class (see
-        # [`predictionClass`](#Version.FIELDS.prediction_class)). Additionally,
-        # include any dependencies used by your Predictor or scikit-learn pipeline
-        # uses that are not already included in your selected [runtime
-        # version](/ml-engine/docs/tensorflow/runtime-version-list).
-        # If you specify this field, you must also set
-        # [`runtimeVersion`](#Version.FIELDS.runtime_version) to 1.4 or greater.
+        # Optional. Cloud Storage paths (`gs://…`) of packages for [custom prediction
+        # routines](/ml-engine/docs/tensorflow/custom-prediction-routines) or [scikit-
+        # learn pipelines with custom code](/ml-engine/docs/scikit/exporting-for-
+        # prediction#custom-pipeline-code). For a custom prediction routine, one of
+        # these packages must contain your Predictor class (see [`predictionClass`](#
+        # Version.FIELDS.prediction_class)). Additionally, include any dependencies used
+        # by your Predictor or scikit-learn pipeline uses that are not already included
+        # in your selected [runtime version](/ml-engine/docs/tensorflow/runtime-version-
+        # list). If you specify this field, you must also set [`runtimeVersion`](#
+        # Version.FIELDS.runtime_version) to 1.4 or greater.
         # Corresponds to the JSON property `packageUris`
         # @return [Array<String>]
         attr_accessor :package_uris
       
-        # Optional. The fully qualified name
-        # (<var>module_name</var>.<var>class_name</var>) of a class that implements
-        # the Predictor interface described in this reference field. The module
-        # containing this class should be included in a package provided to the
-        # [`packageUris` field](#Version.FIELDS.package_uris).
-        # Specify this field if and only if you are deploying a [custom prediction
-        # routine (beta)](/ml-engine/docs/tensorflow/custom-prediction-routines).
-        # If you specify this field, you must set
-        # [`runtimeVersion`](#Version.FIELDS.runtime_version) to 1.4 or greater and
-        # you must set `machineType` to a [legacy (MLS1)
-        # machine type](/ml-engine/docs/machine-types-online-prediction).
-        # The following code sample provides the Predictor interface:
-        # <pre style="max-width: 626px;">
-        # class Predictor(object):
-        # """Interface for constructing custom predictors."""
-        # def predict(self, instances, **kwargs):
-        # """Performs custom prediction.
-        # Instances are the decoded values from the request. They have already
-        # been deserialized from JSON.
-        # Args:
-        # instances: A list of prediction input instances.
-        # **kwargs: A dictionary of keyword args provided as additional
-        # fields on the predict request body.
-        # Returns:
-        # A list of outputs containing the prediction results. This list must
-        # be JSON serializable.
-        # """
-        # raise NotImplementedError()
-        # @classmethod
-        # def from_path(cls, model_dir):
-        # """Creates an instance of Predictor using the given path.
-        # Loading of the predictor should be done in this method.
-        # Args:
-        # model_dir: The local directory that contains the exported model
-        # file along with any additional files uploaded when creating the
-        # version resource.
-        # Returns:
-        # An instance implementing this Predictor class.
-        # """
-        # raise NotImplementedError()
-        # </pre>
-        # Learn more about [the Predictor interface and custom prediction
-        # routines](/ml-engine/docs/tensorflow/custom-prediction-routines).
+        # Optional. The fully qualified name (module_name.class_name) of a class that
+        # implements the Predictor interface described in this reference field. The
+        # module containing this class should be included in a package provided to the [`
+        # packageUris` field](#Version.FIELDS.package_uris). Specify this field if and
+        # only if you are deploying a [custom prediction routine (beta)](/ml-engine/docs/
+        # tensorflow/custom-prediction-routines). If you specify this field, you must
+        # set [`runtimeVersion`](#Version.FIELDS.runtime_version) to 1.4 or greater and
+        # you must set `machineType` to a [legacy (MLS1) machine type](/ml-engine/docs/
+        # machine-types-online-prediction). The following code sample provides the
+        # Predictor interface: class Predictor(object): """Interface for constructing
+        # custom predictors.""" def predict(self, instances, **kwargs): """Performs
+        # custom prediction. Instances are the decoded values from the request. They
+        # have already been deserialized from JSON. Args: instances: A list of
+        # prediction input instances. **kwargs: A dictionary of keyword args provided as
+        # additional fields on the predict request body. Returns: A list of outputs
+        # containing the prediction results. This list must be JSON serializable. """
+        # raise NotImplementedError() @classmethod def from_path(cls, model_dir): """
+        # Creates an instance of Predictor using the given path. Loading of the
+        # predictor should be done in this method. Args: model_dir: The local directory
+        # that contains the exported model file along with any additional files uploaded
+        # when creating the version resource. Returns: An instance implementing this
+        # Predictor class. """ raise NotImplementedError() Learn more about [the
+        # Predictor interface and custom prediction routines](/ml-engine/docs/tensorflow/
+        # custom-prediction-routines).
         # Corresponds to the JSON property `predictionClass`
         # @return [String]
         attr_accessor :prediction_class
       
-        # Required. The version of Python used in prediction.
-        # 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.
-        # Read more about the Python versions available for [each runtime
-        # version](/ml-engine/docs/runtime-version-list).
+        # Required. The version of Python used in prediction. 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. 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.
-        # Online prediction requests to a model version and the responses to these
-        # requests are converted to raw strings and saved to the specified BigQuery
-        # table. Logging is constrained by [BigQuery quotas and
-        # limits](/bigquery/quotas). If your project exceeds BigQuery quotas or limits,
-        # AI Platform Prediction does not log request-response pairs, but it continues
-        # to serve predictions.
-        # If you are using [continuous
-        # evaluation](/ml-engine/docs/continuous-evaluation/), you do not need to
-        # specify this configuration manually. Setting up continuous evaluation
+        # Configuration for logging request-response pairs to a BigQuery table. Online
+        # prediction requests to a model version and the responses to these requests are
+        # converted to raw strings and saved to the specified BigQuery table. Logging is
+        # constrained by [BigQuery quotas and limits](/bigquery/quotas). If your project
+        # exceeds BigQuery quotas or limits, AI Platform Prediction does not log request-
+        # response pairs, but it continues to serve predictions. If you are using [
+        # continuous evaluation](/ml-engine/docs/continuous-evaluation/), you do not
+        # need to specify this configuration manually. Setting up continuous evaluation
         # automatically enables logging of request-response pairs.
         # Corresponds to the JSON property `requestLoggingConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1RequestLoggingConfig]
         attr_accessor :request_logging_config
       
-        # Required. The AI Platform runtime version to use for this deployment.
-        # For more information, see the
-        # [runtime version list](/ml-engine/docs/runtime-version-list) and
-        # [how to manage runtime versions](/ml-engine/docs/versioning).
+        # Specifies HTTP paths served by a custom container. AI Platform Prediction
+        # sends requests to these paths on the container; the custom container must run
+        # an HTTP server that responds to these requests with appropriate responses.
+        # Read [Custom container requirements](/ai-platform/prediction/docs/custom-
+        # container-requirements) for details on how to create your container image to
+        # meet these requirements.
+        # Corresponds to the JSON property `routes`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1RouteMap]
+        attr_accessor :routes
+      
+        # Required. The AI Platform runtime version to use for this deployment. 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
       
-        # Optional. Specifies the service account for resource access control.
+        # Optional. Specifies the service account for resource access control. If you
+        # specify this field, then you must also specify either the `containerSpec` or
+        # the `predictionClass` field. Learn more about [using a custom service account](
+        # /ai-platform/prediction/docs/custom-service-account).
         # Corresponds to the JSON property `serviceAccount`
         # @return [String]
         attr_accessor :service_account
@@ -3048,6 +3157,7 @@ module Google
         def update!(**args)
           @accelerator_config = args[:accelerator_config] if args.key?(:accelerator_config)
           @auto_scaling = args[:auto_scaling] if args.key?(:auto_scaling)
+          @container = args[:container] if args.key?(:container)
           @create_time = args[:create_time] if args.key?(:create_time)
           @deployment_uri = args[:deployment_uri] if args.key?(:deployment_uri)
           @description = args[:description] if args.key?(:description)
@@ -3065,22 +3175,23 @@ module Google
           @prediction_class = args[:prediction_class] if args.key?(:prediction_class)
           @python_version = args[:python_version] if args.key?(:python_version)
           @request_logging_config = args[:request_logging_config] if args.key?(:request_logging_config)
+          @routes = args[:routes] if args.key?(:routes)
           @runtime_version = args[:runtime_version] if args.key?(:runtime_version)
           @service_account = args[:service_account] if args.key?(:service_account)
           @state = args[:state] if args.key?(:state)
         end
       end
       
-      # Attributes credit by computing the XRAI taking advantage
-      # of the model's fully differentiable structure. Refer to this paper for
-      # more details: https://arxiv.org/abs/1906.02825
-      # Currently only implemented for models with natural image inputs.
+      # Attributes credit by computing the XRAI taking advantage of the model's fully
+      # differentiable structure. Refer to this paper for more details: https://arxiv.
+      # org/abs/1906.02825 Currently only implemented for models with natural image
+      # inputs.
       class GoogleCloudMlV1XraiAttribution
         include Google::Apis::Core::Hashable
       
-        # Number of steps for approximating the path integral.
-        # A good value to start is 50 and gradually increase until the
-        # sum to diff property is met within the desired error range.
+        # Number of steps for approximating the path integral. A good value to start is
+        # 50 and gradually increase until the sum to diff property is met within the
+        # desired error range.
         # Corresponds to the JSON property `numIntegralSteps`
         # @return [Fixnum]
         attr_accessor :num_integral_steps
@@ -3095,53 +3206,21 @@ module Google
         end
       end
       
-      # Specifies the audit configuration for a service.
-      # The configuration determines which permission types are logged, and what
-      # identities, if any, are exempted from logging.
-      # An AuditConfig must have one or more AuditLogConfigs.
-      # If there are AuditConfigs for both `allServices` and a specific service,
-      # the union of the two AuditConfigs is used for that service: the log_types
-      # specified in each AuditConfig are enabled, and the exempted_members in each
-      # AuditLogConfig are exempted.
-      # Example Policy with multiple AuditConfigs:
-      # `
-      # "audit_configs": [
-      # `
-      # "service": "allServices",
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `,
-      # `
-      # "log_type": "ADMIN_READ"
-      # `
-      # ]
-      # `,
-      # `
-      # "service": "sampleservice.googleapis.com",
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ"
-      # `,
-      # `
-      # "log_type": "DATA_WRITE",
-      # "exempted_members": [
-      # "user:aliya@example.com"
-      # ]
-      # `
-      # ]
-      # `
-      # ]
-      # `
-      # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-      # logging. It also exempts jose@example.com from DATA_READ logging, and
-      # aliya@example.com from DATA_WRITE logging.
+      # Specifies the audit configuration for a service. The configuration determines
+      # which permission types are logged, and what identities, if any, are exempted
+      # from logging. An AuditConfig must have one or more AuditLogConfigs. If there
+      # are AuditConfigs for both `allServices` and a specific service, the union of
+      # the two AuditConfigs is used for that service: the log_types specified in each
+      # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are
+      # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` "
+      # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", "
+      # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `,
+      # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com",
+      # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE"
+      # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice,
+      # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also
+      # exempts jose@example.com from DATA_READ logging, and aliya@example.com from
+      # DATA_WRITE logging.
       class GoogleIamV1AuditConfig
         include Google::Apis::Core::Hashable
       
@@ -3150,9 +3229,9 @@ module Google
         # @return [Array<Google::Apis::MlV1::GoogleIamV1AuditLogConfig>]
         attr_accessor :audit_log_configs
       
-        # Specifies a service that will be enabled for audit logging.
-        # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
-        # `allServices` is a special value that covers all services.
+        # Specifies a service that will be enabled for audit logging. For example, `
+        # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special
+        # value that covers all services.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -3168,28 +3247,15 @@ module Google
         end
       end
       
-      # Provides the configuration for logging a type of permissions.
-      # Example:
-      # `
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `
-      # ]
-      # `
-      # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
-      # jose@example.com from DATA_READ logging.
+      # Provides the configuration for logging a type of permissions. Example: ` "
+      # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user:
+      # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables '
+      # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from
+      # DATA_READ logging.
       class GoogleIamV1AuditLogConfig
         include Google::Apis::Core::Hashable
       
-        # Specifies the identities that do not cause logging for this type of
-        # permission.
+        # Specifies the identities that do not cause logging for this type of permission.
         # Follows the same format of Binding.members.
         # Corresponds to the JSON property `exemptedMembers`
         # @return [Array<String>]
@@ -3215,69 +3281,63 @@ module Google
       class GoogleIamV1Binding
         include Google::Apis::Core::Hashable
       
-        # 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.
+        # A client-specified ID for this binding. Expected to be globally unique to
+        # support the internal bindings-by-ID API.
+        # Corresponds to the JSON property `bindingId`
+        # @return [String]
+        attr_accessor :binding_id
+      
+        # 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.
-        # `members` can have the following values:
-        # * `allUsers`: A special identifier that represents anyone who is
-        # on the internet; with or without a Google account.
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
-        # who is authenticated with a Google account or a service account.
-        # * `user:`emailid``: An email address that represents a specific Google
-        # account. For example, `alice@example.com` .
-        # * `serviceAccount:`emailid``: An email address that represents a service
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
-        # * `group:`emailid``: An email address that represents a Google group.
-        # 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
-        # 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
-        # unique identifier) representing a service account that has been recently
-        # deleted. For example,
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # If the service account is undeleted, this value reverts to
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
-        # role in the binding.
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # identifier) representing a Google group that has been recently
-        # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
-        # the group is recovered, this value reverts to `group:`emailid`` and the
-        # recovered group retains the role in the binding.
-        # * `domain:`domain``: The G Suite domain (primary) that represents all the
-        # users of that domain. For example, `google.com` or `example.com`.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
+        # members` can have the following values: * `allUsers`: A special identifier
+        # that represents anyone who is on the internet; with or without a Google
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
+        # anyone who is authenticated with a Google account or a service account. * `
+        # user:`emailid``: An email address that represents a specific Google account.
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
+        # address that represents a service account. For example, `my-other-app@appspot.
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
+        # Google group. 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 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 unique
+        # identifier) representing a service account that has been recently deleted. For
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
+        # emailid`` and the undeleted service account retains the role in the binding. *
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a Google group that has been recently deleted. For
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
+        # primary) that represents all the users of that domain. For example, `google.
+        # com` or `example.com`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
         attr_accessor :members
       
-        # Role that is assigned to `members`.
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -3288,6 +3348,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @binding_id = args[:binding_id] if args.key?(:binding_id)
           @condition = args[:condition] if args.key?(:condition)
           @members = args[:members] if args.key?(:members)
           @role = args[:role] if args.key?(:role)
@@ -3295,66 +3356,32 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
-      # `members` to a single `role`. Members can be user accounts, service accounts,
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
-      # permissions; each `role` can be an IAM predefined role or a user-created
-      # custom role.
-      # For some types of Google Cloud resources, a `binding` can also specify a
-      # `condition`, which is a logical expression that allows access to a resource
-      # only if the expression evaluates to `true`. A condition can add constraints
-      # based on attributes of the request, the resource, or both. To learn which
-      # resources support conditions in their IAM policies, see the
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-      # policies).
-      # **JSON example:**
-      # `
-      # "bindings": [
-      # `
-      # "role": "roles/resourcemanager.organizationAdmin",
-      # "members": [
-      # "user:mike@example.com",
-      # "group:admins@example.com",
-      # "domain:google.com",
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-      # ]
-      # `,
-      # `
-      # "role": "roles/resourcemanager.organizationViewer",
-      # "members": [
-      # "user:eve@example.com"
-      # ],
-      # "condition": `
-      # "title": "expirable access",
-      # "description": "Does not grant access after Sep 2020",
-      # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # ",
-      # `
-      # `
-      # ],
-      # "etag": "BwWWja0YfJA=",
-      # "version": 3
-      # `
-      # **YAML example:**
-      # bindings:
-      # - members:
-      # - user:mike@example.com
-      # - group:admins@example.com
-      # - domain:google.com
-      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-      # role: roles/resourcemanager.organizationAdmin
-      # - members:
-      # - user:eve@example.com
-      # role: roles/resourcemanager.organizationViewer
-      # condition:
-      # title: expirable access
-      # description: Does not grant access after Sep 2020
-      # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # - etag: BwWWja0YfJA=
-      # - version: 3
-      # For a description of IAM and its features, see the
-      # [IAM documentation](https://cloud.google.com/iam/docs/).
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
+      # A `binding` binds one or more `members` to a single `role`. Members can be
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
+      # role or a user-created custom role. For some types of Google Cloud resources,
+      # a `binding` can also specify a `condition`, which is a logical expression that
+      # allows access to a resource only if the expression evaluates to `true`. A
+      # condition can add constraints based on attributes of the request, the resource,
+      # or both. To learn which resources support conditions in their IAM policies,
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
+      # title": "expirable access", "description": "Does not grant access after Sep
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
+      # description: Does not grant access after Sep 2020 expression: request.time <
+      # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
+      # description of IAM and its features, see the [IAM documentation](https://cloud.
+      # google.com/iam/docs/).
       class GoogleIamV1Policy
         include Google::Apis::Core::Hashable
       
@@ -3363,48 +3390,44 @@ module Google
         # @return [Array<Google::Apis::MlV1::GoogleIamV1AuditConfig>]
         attr_accessor :audit_configs
       
-        # Associates a list of `members` to a `role`. Optionally, may specify a
-        # `condition` that determines how and when the `bindings` are applied. Each
-        # of the `bindings` must contain at least one member.
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
+        # condition` that determines how and when the `bindings` are applied. Each of
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::MlV1::GoogleIamV1Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
-        # prevent simultaneous updates of a policy from overwriting each other.
-        # It is strongly suggested that systems make use of the `etag` in the
-        # read-modify-write cycle to perform policy updates in order to avoid race
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
-        # systems are expected to put that etag in the request to `setIamPolicy` to
-        # ensure that their change will be applied to the same version of the policy.
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
-        # the conditions in the version `3` policy are lost.
+        # `etag` is used for optimistic concurrency control as a way to help prevent
+        # simultaneous updates of a policy from overwriting each other. It is strongly
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
+        # to perform policy updates in order to avoid race conditions: An `etag` is
+        # returned in the response to `getIamPolicy`, and systems are expected to put
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
+        # applied to the same version of the policy. **Important:** If you use IAM
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
+        # with a version `1` policy, and all of the conditions in the version `3` policy
+        # are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Specifies the format of the policy.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
-        # are rejected.
-        # Any operation that affects conditional role bindings must specify version
-        # `3`. This requirement applies to the following operations:
-        # * Getting a policy that includes a conditional role binding
-        # * Adding a conditional role binding to a policy
-        # * Changing a conditional role binding in a policy
-        # * Removing any role binding, with or without a condition, from a policy
-        # that includes conditions
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
-        # the conditions in the version `3` policy are lost.
-        # If a policy does not include any conditions, operations on that policy may
-        # specify any valid version or leave the field unset.
-        # To learn which resources support conditions in their IAM policies, see the
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-        # policies).
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
+        # Requests that specify an invalid value are rejected. Any operation that
+        # affects conditional role bindings must specify version `3`. This requirement
+        # applies to the following operations: * Getting a policy that includes a
+        # conditional role binding * Adding a conditional role binding to a policy *
+        # Changing a conditional role binding in a policy * Removing any role binding,
+        # with or without a condition, from a policy that includes conditions **
+        # Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
+        # conditions in the version `3` policy are lost. If a policy does not include
+        # any conditions, operations on that policy may specify any valid version or
+        # leave the field unset. To learn which resources support conditions in their
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
+        # conditions/resource-policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -3427,74 +3450,39 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
-        # `members` to a single `role`. Members can be user accounts, service accounts,
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
-        # permissions; each `role` can be an IAM predefined role or a user-created
-        # custom role.
-        # For some types of Google Cloud resources, a `binding` can also specify a
-        # `condition`, which is a logical expression that allows access to a resource
-        # only if the expression evaluates to `true`. A condition can add constraints
-        # based on attributes of the request, the resource, or both. To learn which
-        # resources support conditions in their IAM policies, see the
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-        # policies).
-        # **JSON example:**
-        # `
-        # "bindings": [
-        # `
-        # "role": "roles/resourcemanager.organizationAdmin",
-        # "members": [
-        # "user:mike@example.com",
-        # "group:admins@example.com",
-        # "domain:google.com",
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-        # ]
-        # `,
-        # `
-        # "role": "roles/resourcemanager.organizationViewer",
-        # "members": [
-        # "user:eve@example.com"
-        # ],
-        # "condition": `
-        # "title": "expirable access",
-        # "description": "Does not grant access after Sep 2020",
-        # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # ",
-        # `
-        # `
-        # ],
-        # "etag": "BwWWja0YfJA=",
-        # "version": 3
-        # `
-        # **YAML example:**
-        # bindings:
-        # - members:
-        # - user:mike@example.com
-        # - group:admins@example.com
-        # - domain:google.com
-        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-        # role: roles/resourcemanager.organizationAdmin
-        # - members:
-        # - user:eve@example.com
-        # role: roles/resourcemanager.organizationViewer
-        # condition:
-        # title: expirable access
-        # description: Does not grant access after Sep 2020
-        # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # - etag: BwWWja0YfJA=
-        # - version: 3
-        # For a description of IAM and its features, see the
-        # [IAM documentation](https://cloud.google.com/iam/docs/).
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
+        # A `binding` binds one or more `members` to a single `role`. Members can be
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
+        # role or a user-created custom role. For some types of Google Cloud resources,
+        # a `binding` can also specify a `condition`, which is a logical expression that
+        # allows access to a resource only if the expression evaluates to `true`. A
+        # condition can add constraints based on attributes of the request, the resource,
+        # or both. To learn which resources support conditions in their IAM policies,
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
+        # title": "expirable access", "description": "Does not grant access after Sep
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
+        # description: Does not grant access after Sep 2020 expression: request.time <
+        # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
+        # description of IAM and its features, see the [IAM documentation](https://cloud.
+        # google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::MlV1::GoogleIamV1Policy]
         attr_accessor :policy
       
         # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
-        # the fields in the mask will be modified. If no mask is provided, the
-        # following default mask is used:
-        # `paths: "bindings, etag"`
+        # the fields in the mask will be modified. If no mask is provided, the following
+        # default mask is used: `paths: "bindings, etag"`
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -3514,10 +3502,9 @@ module Google
       class GoogleIamV1TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
-        # information see
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+        # The set of permissions to check for the `resource`. Permissions with wildcards
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -3536,8 +3523,7 @@ module Google
       class GoogleIamV1TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
-        # allowed.
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -3582,47 +3568,45 @@ module Google
       class GoogleLongrunningOperation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::MlV1::GoogleRpcStatus]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
-        # method returns no data on success, such as `Delete`, the response is
-        # `google.protobuf.Empty`.  If the original method is standard
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
-        # is the original method name.  For example, if the original method name
-        # is `TakeSnapshot()`, the inferred response type is
-        # `TakeSnapshotResponse`.
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as `Delete`, the response is `google.
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
+        # the response should be the resource. For other methods, the response should
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
+        # example, if the original method name is `TakeSnapshot()`, the inferred
+        # response type is `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -3641,13 +3625,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class GoogleProtobufEmpty
         include Google::Apis::Core::Hashable
       
@@ -3660,12 +3642,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class GoogleRpcStatus
         include Google::Apis::Core::Hashable
       
@@ -3674,15 +3656,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -3699,52 +3681,43 @@ module Google
         end
       end
       
-      # 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.
+      # 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
       
-        # Optional. Description of the expression. This is a longer text which
-        # describes the expression, e.g. when hovered over it in a UI.
+        # 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.
+        # Textual representation of an expression in Common Expression Language syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
-        # reporting, e.g. a file name and a position in the file.
+        # 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
       
-        # 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.
+        # 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