google-cloud-ai_platform-v1 0.16.0 → 0.17.0

data/lib/google/cloud/ai_platform/v1/job_service/client.rb

@@ -408,8 +408,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListCustomJobsResponse#next_page_token ListCustomJobsResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::JobService::Client#list_custom_jobs JobService.ListCustomJobs} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListCustomJobsResponse#next_page_token ListCustomJobsResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::JobService::Client#list_custom_jobs JobService.ListCustomJobs}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #
@@ -583,12 +585,15 @@ module Google
             # Cancels a CustomJob.
             # Starts asynchronous cancellation on the CustomJob. The server
             # makes a best effort to cancel the job, but success is not
-            # guaranteed. Clients can use {::Google::Cloud::AIPlatform::V1::JobService::Client#get_custom_job JobService.GetCustomJob} or
-            # other methods to check whether the cancellation succeeded or whether the
+            # guaranteed. Clients can use
+            # {::Google::Cloud::AIPlatform::V1::JobService::Client#get_custom_job JobService.GetCustomJob}
+            # or other methods to check whether the cancellation succeeded or whether the
             # job completed despite cancellation. On successful cancellation,
             # the CustomJob is not deleted; instead it becomes a job with
-            # a {::Google::Cloud::AIPlatform::V1::CustomJob#error CustomJob.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-            # corresponding to `Code.CANCELLED`, and {::Google::Cloud::AIPlatform::V1::CustomJob#state CustomJob.state} is set to
+            # a {::Google::Cloud::AIPlatform::V1::CustomJob#error CustomJob.error} value with
+            # a {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
+            # `Code.CANCELLED`, and
+            # {::Google::Cloud::AIPlatform::V1::CustomJob#state CustomJob.state} is set to
             # `CANCELLED`.
             #
             # @overload cancel_custom_job(request, options = nil)
@@ -1178,8 +1183,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the Location to create the HyperparameterTuningJob in.
-            #     Format: `projects/{project}/locations/{location}`
+            #     Required. The resource name of the Location to create the
+            #     HyperparameterTuningJob in. Format:
+            #     `projects/{project}/locations/{location}`
             #   @param hyperparameter_tuning_job [::Google::Cloud::AIPlatform::V1::HyperparameterTuningJob, ::Hash]
             #     Required. The HyperparameterTuningJob to create.
             #
@@ -1353,8 +1359,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the Location to list the HyperparameterTuningJobs
-            #     from. Format: `projects/{project}/locations/{location}`
+            #     Required. The resource name of the Location to list the
+            #     HyperparameterTuningJobs from. Format:
+            #     `projects/{project}/locations/{location}`
             #   @param filter [::String]
             #     The standard list filter.
             #
@@ -1381,8 +1388,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListHyperparameterTuningJobsResponse#next_page_token ListHyperparameterTuningJobsResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::JobService::Client#list_hyperparameter_tuning_jobs JobService.ListHyperparameterTuningJobs} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListHyperparameterTuningJobsResponse#next_page_token ListHyperparameterTuningJobsResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::JobService::Client#list_hyperparameter_tuning_jobs JobService.ListHyperparameterTuningJobs}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #
@@ -1556,13 +1565,17 @@ module Google
             # Cancels a HyperparameterTuningJob.
             # Starts asynchronous cancellation on the HyperparameterTuningJob. The server
             # makes a best effort to cancel the job, but success is not
-            # guaranteed. Clients can use {::Google::Cloud::AIPlatform::V1::JobService::Client#get_hyperparameter_tuning_job JobService.GetHyperparameterTuningJob} or
-            # other methods to check whether the cancellation succeeded or whether the
+            # guaranteed. Clients can use
+            # {::Google::Cloud::AIPlatform::V1::JobService::Client#get_hyperparameter_tuning_job JobService.GetHyperparameterTuningJob}
+            # or other methods to check whether the cancellation succeeded or whether the
             # job completed despite cancellation. On successful cancellation,
             # the HyperparameterTuningJob is not deleted; instead it becomes a job with
-            # a {::Google::Cloud::AIPlatform::V1::HyperparameterTuningJob#error HyperparameterTuningJob.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code}
-            # of 1, corresponding to `Code.CANCELLED`, and
-            # {::Google::Cloud::AIPlatform::V1::HyperparameterTuningJob#state HyperparameterTuningJob.state} is set to `CANCELLED`.
+            # a
+            # {::Google::Cloud::AIPlatform::V1::HyperparameterTuningJob#error HyperparameterTuningJob.error}
+            # value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
+            # corresponding to `Code.CANCELLED`, and
+            # {::Google::Cloud::AIPlatform::V1::HyperparameterTuningJob#state HyperparameterTuningJob.state}
+            # is set to `CANCELLED`.
             #
             # @overload cancel_hyperparameter_tuning_job(request, options = nil)
             #   Pass arguments to `cancel_hyperparameter_tuning_job` via a request object, either of type
@@ -1668,8 +1681,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the Location to create the BatchPredictionJob in.
-            #     Format: `projects/{project}/locations/{location}`
+            #     Required. The resource name of the Location to create the
+            #     BatchPredictionJob in. Format: `projects/{project}/locations/{location}`
             #   @param batch_prediction_job [::Google::Cloud::AIPlatform::V1::BatchPredictionJob, ::Hash]
             #     Required. The BatchPredictionJob to create.
             #
@@ -1872,8 +1885,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListBatchPredictionJobsResponse#next_page_token ListBatchPredictionJobsResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::JobService::Client#list_batch_prediction_jobs JobService.ListBatchPredictionJobs} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListBatchPredictionJobsResponse#next_page_token ListBatchPredictionJobsResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::JobService::Client#list_batch_prediction_jobs JobService.ListBatchPredictionJobs}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #
@@ -2049,12 +2064,14 @@ module Google
             #
             # Starts asynchronous cancellation on the BatchPredictionJob. The server
             # makes the best effort to cancel the job, but success is not
-            # guaranteed. Clients can use {::Google::Cloud::AIPlatform::V1::JobService::Client#get_batch_prediction_job JobService.GetBatchPredictionJob} or
-            # other methods to check whether the cancellation succeeded or whether the
+            # guaranteed. Clients can use
+            # {::Google::Cloud::AIPlatform::V1::JobService::Client#get_batch_prediction_job JobService.GetBatchPredictionJob}
+            # or other methods to check whether the cancellation succeeded or whether the
             # job completed despite cancellation. On a successful cancellation,
             # the BatchPredictionJob is not deleted;instead its
-            # {::Google::Cloud::AIPlatform::V1::BatchPredictionJob#state BatchPredictionJob.state} is set to `CANCELLED`. Any files already
-            # outputted by the job are not deleted.
+            # {::Google::Cloud::AIPlatform::V1::BatchPredictionJob#state BatchPredictionJob.state}
+            # is set to `CANCELLED`. Any files already outputted by the job are not
+            # deleted.
             #
             # @overload cancel_batch_prediction_job(request, options = nil)
             #   Pass arguments to `cancel_batch_prediction_job` via a request object, either of type
@@ -2571,17 +2588,16 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param model_deployment_monitoring_job [::Google::Cloud::AIPlatform::V1::ModelDeploymentMonitoringJob, ::Hash]
-            #     Required. The model monitoring configuration which replaces the resource on the
-            #     server.
+            #     Required. The model monitoring configuration which replaces the resource on
+            #     the server.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The update mask is used to specify the fields to be overwritten in the
-            #     ModelDeploymentMonitoringJob resource by the update.
-            #     The fields specified in the update_mask are relative to the resource, not
-            #     the full request. A field will be overwritten if it is in the mask. If the
-            #     user does not provide a mask then only the non-empty fields present in the
-            #     request will be overwritten. Set the update_mask to `*` to override all
-            #     fields.
-            #     For the objective config, the user can either provide the update mask for
+            #     Required. The update mask is used to specify the fields to be overwritten
+            #     in the ModelDeploymentMonitoringJob resource by the update. The fields
+            #     specified in the update_mask are relative to the resource, not the full
+            #     request. A field will be overwritten if it is in the mask. If the user does
+            #     not provide a mask then only the non-empty fields present in the request
+            #     will be overwritten. Set the update_mask to `*` to override all fields. For
+            #     the objective config, the user can either provide the update mask for
             #     model_deployment_monitoring_objective_configs or any combination of its
             #     nested fields, such as:
             #     model_deployment_monitoring_objective_configs.objective_config.training_dataset.
@@ -2772,7 +2788,8 @@ module Google
             ##
             # Pauses a ModelDeploymentMonitoringJob. If the job is running, the server
             # makes a best effort to cancel the job. Will mark
-            # {::Google::Cloud::AIPlatform::V1::ModelDeploymentMonitoringJob#state ModelDeploymentMonitoringJob.state} to 'PAUSED'.
+            # {::Google::Cloud::AIPlatform::V1::ModelDeploymentMonitoringJob#state ModelDeploymentMonitoringJob.state}
+            # to 'PAUSED'.
             #
             # @overload pause_model_deployment_monitoring_job(request, options = nil)
             #   Pass arguments to `pause_model_deployment_monitoring_job` via a request object, either of type

data/lib/google/cloud/ai_platform/v1/job_service.rb

@@ -34,7 +34,7 @@ module Google
         ##
         # A service for creating and managing Vertex AI's jobs.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/ai_platform/v1/job_service"
         #     client = ::Google::Cloud::AIPlatform::V1::JobService::Client.new

data/lib/google/cloud/ai_platform/v1/metadata_service/client.rb

@@ -406,8 +406,8 @@ module Google
             #     Must be in range 1-1000, inclusive. Defaults to 100.
             #   @param page_token [::String]
             #     A page token, received from a previous
-            #     {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_metadata_stores MetadataService.ListMetadataStores} call. Provide this to retrieve the
-            #     subsequent page.
+            #     {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_metadata_stores MetadataService.ListMetadataStores}
+            #     call. Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other provided parameters must match the call that
             #     provided the page token. (Otherwise the request will fail with
@@ -793,7 +793,8 @@ module Google
             #     The maximum number of Artifacts to return. The service may return fewer.
             #     Must be in range 1-1000, inclusive. Defaults to 100.
             #   @param page_token [::String]
-            #     A page token, received from a previous {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_artifacts MetadataService.ListArtifacts}
+            #     A page token, received from a previous
+            #     {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_artifacts MetadataService.ListArtifacts}
             #     call. Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other provided parameters must match the call that
@@ -927,15 +928,15 @@ module Google
             #
             #   @param artifact [::Google::Cloud::AIPlatform::V1::Artifact, ::Hash]
             #     Required. The Artifact containing updates.
-            #     The Artifact's {::Google::Cloud::AIPlatform::V1::Artifact#name Artifact.name} field is used to identify the Artifact to
-            #     be updated.
-            #     Format:
+            #     The Artifact's {::Google::Cloud::AIPlatform::V1::Artifact#name Artifact.name}
+            #     field is used to identify the Artifact to be updated. Format:
             #     `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}`
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Optional. A FieldMask indicating which fields should be updated.
             #     Functionality of this field is not yet supported.
             #   @param allow_missing [::Boolean]
-            #     If set to true, and the {::Google::Cloud::AIPlatform::V1::Artifact Artifact} is not found, a new {::Google::Cloud::AIPlatform::V1::Artifact Artifact} is
+            #     If set to true, and the {::Google::Cloud::AIPlatform::V1::Artifact Artifact} is
+            #     not found, a new {::Google::Cloud::AIPlatform::V1::Artifact Artifact} is
             #     created.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1222,9 +1223,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the MetadataStore where the Context should be
-            #     created.
-            #     Format:
+            #     Required. The resource name of the MetadataStore where the Context should
+            #     be created. Format:
             #     `projects/{project}/locations/{location}/metadataStores/{metadatastore}`
             #   @param context [::Google::Cloud::AIPlatform::V1::Context, ::Hash]
             #     Required. The Context to create.
@@ -1414,7 +1414,8 @@ module Google
             #     The maximum number of Contexts to return. The service may return fewer.
             #     Must be in range 1-1000, inclusive. Defaults to 100.
             #   @param page_token [::String]
-            #     A page token, received from a previous {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_contexts MetadataService.ListContexts}
+            #     A page token, received from a previous
+            #     {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_contexts MetadataService.ListContexts}
             #     call. Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other provided parameters must match the call that
@@ -1552,16 +1553,15 @@ module Google
             #
             #   @param context [::Google::Cloud::AIPlatform::V1::Context, ::Hash]
             #     Required. The Context containing updates.
-            #     The Context's {::Google::Cloud::AIPlatform::V1::Context#name Context.name} field is used to identify the Context to be
-            #     updated.
-            #     Format:
+            #     The Context's {::Google::Cloud::AIPlatform::V1::Context#name Context.name} field
+            #     is used to identify the Context to be updated. Format:
             #     `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}`
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Optional. A FieldMask indicating which fields should be updated.
             #     Functionality of this field is not yet supported.
             #   @param allow_missing [::Boolean]
-            #     If set to true, and the {::Google::Cloud::AIPlatform::V1::Context Context} is not found, a new {::Google::Cloud::AIPlatform::V1::Context Context} is
-            #     created.
+            #     If set to true, and the {::Google::Cloud::AIPlatform::V1::Context Context} is
+            #     not found, a new {::Google::Cloud::AIPlatform::V1::Context Context} is created.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::Context]
@@ -1852,9 +1852,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param context [::String]
-            #     Required. The resource name of the Context that the Artifacts and Executions
-            #     belong to.
-            #     Format:
+            #     Required. The resource name of the Context that the Artifacts and
+            #     Executions belong to. Format:
             #     `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}`
             #   @param artifacts [::Array<::String>]
             #     The resource names of the Artifacts to attribute to the Context.
@@ -2423,7 +2422,8 @@ module Google
             #     The maximum number of Executions to return. The service may return fewer.
             #     Must be in range 1-1000, inclusive. Defaults to 100.
             #   @param page_token [::String]
-            #     A page token, received from a previous {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_executions MetadataService.ListExecutions}
+            #     A page token, received from a previous
+            #     {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_executions MetadataService.ListExecutions}
             #     call. Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other provided parameters must match the call that
@@ -2557,16 +2557,16 @@ module Google
             #
             #   @param execution [::Google::Cloud::AIPlatform::V1::Execution, ::Hash]
             #     Required. The Execution containing updates.
-            #     The Execution's {::Google::Cloud::AIPlatform::V1::Execution#name Execution.name} field is used to identify the Execution
-            #     to be updated.
-            #     Format:
+            #     The Execution's {::Google::Cloud::AIPlatform::V1::Execution#name Execution.name}
+            #     field is used to identify the Execution to be updated. Format:
             #     `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Optional. A FieldMask indicating which fields should be updated.
             #     Functionality of this field is not yet supported.
             #   @param allow_missing [::Boolean]
-            #     If set to true, and the {::Google::Cloud::AIPlatform::V1::Execution Execution} is not found, a new {::Google::Cloud::AIPlatform::V1::Execution Execution}
-            #     is created.
+            #     If set to true, and the {::Google::Cloud::AIPlatform::V1::Execution Execution}
+            #     is not found, a new {::Google::Cloud::AIPlatform::V1::Execution Execution} is
+            #     created.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::Execution]
@@ -2947,9 +2947,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param execution [::String]
-            #     Required. The resource name of the Execution whose input and output Artifacts should
-            #     be retrieved as a LineageSubgraph.
-            #     Format:
+            #     Required. The resource name of the Execution whose input and output
+            #     Artifacts should be retrieved as a LineageSubgraph. Format:
             #     `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -3035,9 +3034,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the MetadataStore where the MetadataSchema should
-            #     be created.
-            #     Format:
+            #     Required. The resource name of the MetadataStore where the MetadataSchema
+            #     should be created. Format:
             #     `projects/{project}/locations/{location}/metadataStores/{metadatastore}`
             #   @param metadata_schema [::Google::Cloud::AIPlatform::V1::MetadataSchema, ::Hash]
             #     Required. The MetadataSchema to create.
@@ -3230,8 +3228,8 @@ module Google
             #     Must be in range 1-1000, inclusive. Defaults to 100.
             #   @param page_token [::String]
             #     A page token, received from a previous
-            #     {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_metadata_schemas MetadataService.ListMetadataSchemas} call. Provide this to retrieve the
-            #     next page.
+            #     {::Google::Cloud::AIPlatform::V1::MetadataService::Client#list_metadata_schemas MetadataService.ListMetadataSchemas}
+            #     call. Provide this to retrieve the next page.
             #
             #     When paginating, all other provided parameters must match the call that
             #     provided the page token. (Otherwise the request will fail with
@@ -3330,9 +3328,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param artifact [::String]
-            #     Required. The resource name of the Artifact whose Lineage needs to be retrieved as a
-            #     LineageSubgraph.
-            #     Format:
+            #     Required. The resource name of the Artifact whose Lineage needs to be
+            #     retrieved as a LineageSubgraph. Format:
             #     `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}`
             #
             #     The request may error with FAILED_PRECONDITION if the number of Artifacts,

data/lib/google/cloud/ai_platform/v1/metadata_service.rb

@@ -34,7 +34,7 @@ module Google
         ##
         # Service for reading and writing metadata entries.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/ai_platform/v1/metadata_service"
         #     client = ::Google::Cloud::AIPlatform::V1::MetadataService::Client.new

data/lib/google/cloud/ai_platform/v1/migration_service/client.rb

@@ -207,10 +207,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The location that the migratable resources should be searched from.
-            #     It's the Vertex AI location that the resources can be migrated to, not
-            #     the resources' original location.
-            #     Format:
+            #     Required. The location that the migratable resources should be searched
+            #     from. It's the Vertex AI location that the resources can be migrated to,
+            #     not the resources' original location. Format:
             #     `projects/{project}/locations/{location}`
             #   @param page_size [::Integer]
             #     The standard page size.

data/lib/google/cloud/ai_platform/v1/migration_service.rb

@@ -35,7 +35,7 @@ module Google
         # A service that migrates resources from automl.googleapis.com,
         # datalabeling.googleapis.com and ml.googleapis.com to Vertex AI.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/ai_platform/v1/migration_service"
         #     client = ::Google::Cloud::AIPlatform::V1::MigrationService::Client.new

data/lib/google/cloud/ai_platform/v1/model_service/client.rb

@@ -207,8 +207,8 @@ module Google
             #     Required. The resource name of the Location into which to upload the Model.
             #     Format: `projects/{project}/locations/{location}`
             #   @param parent_model [::String]
-            #     Optional. The resource name of the model into which to upload the version. Only
-            #     specify this field when uploading a new version.
+            #     Optional. The resource name of the model into which to upload the version.
+            #     Only specify this field when uploading a new version.
             #   @param model_id [::String]
             #     Optional. The ID to use for the uploaded Model, which will become the final
             #     component of the model resource name.
@@ -420,7 +420,8 @@ module Google
             #     both snake_case and camelCase are supported.
             #
             #       * `model` supports = and !=. `model` represents the Model ID,
-            #         i.e. the last segment of the Model's {::Google::Cloud::AIPlatform::V1::Model#name resource name}.
+            #         i.e. the last segment of the Model's [resource
+            #         name][google.cloud.aiplatform.v1.Model.name].
             #       * `display_name` supports = and !=
             #       * `labels` supports general map functions that is:
             #         * `labels.key=value` - key:value equality
@@ -437,8 +438,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListModelsResponse#next_page_token ListModelsResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::ModelService::Client#list_models ModelService.ListModels} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListModelsResponse#next_page_token ListModelsResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::ModelService::Client#list_models ModelService.ListModels}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #   @param order_by [::String]
@@ -536,7 +539,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_model_versions(name: nil, page_size: nil, page_token: nil, filter: nil, read_mask: nil)
+            # @overload list_model_versions(name: nil, page_size: nil, page_token: nil, filter: nil, read_mask: nil, order_by: nil)
             #   Pass arguments to `list_model_versions` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -548,8 +551,8 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListModelVersionsResponse#next_page_token ListModelVersionsResponse.next_page_token} of the previous
-            #     [ModelService.ListModelversions][] call.
+            #     {::Google::Cloud::AIPlatform::V1::ListModelVersionsResponse#next_page_token ListModelVersionsResponse.next_page_token}
+            #     of the previous [ModelService.ListModelversions][] call.
             #   @param filter [::String]
             #     An expression for filtering the results of the request. For field names
             #     both snake_case and camelCase are supported.
@@ -564,6 +567,15 @@ module Google
             #       * `labels.myKey="myValue"`
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
+            #   @param order_by [::String]
+            #     A comma-separated list of fields to order by, sorted in ascending order.
+            #     Use "desc" after a field name for descending.
+            #     Supported fields:
+            #
+            #       * `create_time`
+            #       * `update_time`
+            #
+            #     Example: `update_time asc, create_time desc`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::AIPlatform::V1::Model>]
@@ -675,7 +687,8 @@ module Google
             #     must update them separately.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Required. The update mask applies to the resource.
-            #     For the `FieldMask` definition, see {::Google::Protobuf::FieldMask google.protobuf.FieldMask}.
+            #     For the `FieldMask` definition, see
+            #     {::Google::Protobuf::FieldMask google.protobuf.FieldMask}.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::Model]
@@ -744,9 +757,12 @@ module Google
             ##
             # Deletes a Model.
             #
-            # A model cannot be deleted if any {::Google::Cloud::AIPlatform::V1::Endpoint Endpoint} resource has a
-            # {::Google::Cloud::AIPlatform::V1::DeployedModel DeployedModel} based on the model in its
-            # {::Google::Cloud::AIPlatform::V1::Endpoint#deployed_models deployed_models} field.
+            # A model cannot be deleted if any
+            # {::Google::Cloud::AIPlatform::V1::Endpoint Endpoint} resource has a
+            # {::Google::Cloud::AIPlatform::V1::DeployedModel DeployedModel} based on the
+            # model in its
+            # {::Google::Cloud::AIPlatform::V1::Endpoint#deployed_models deployed_models}
+            # field.
             #
             # @overload delete_model(request, options = nil)
             #   Pass arguments to `delete_model` via a request object, either of type
@@ -844,7 +860,8 @@ module Google
             #
             # Model version can only be deleted if there are no [DeployedModels][]
             # created from it. Deleting the only version in the Model is not allowed. Use
-            # {::Google::Cloud::AIPlatform::V1::ModelService::Client#delete_model DeleteModel} for deleting the Model instead.
+            # {::Google::Cloud::AIPlatform::V1::ModelService::Client#delete_model DeleteModel} for
+            # deleting the Model instead.
             #
             # @overload delete_model_version(request, options = nil)
             #   Pass arguments to `delete_model_version` via a request object, either of type
@@ -862,8 +879,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the model version to be deleted, with a version ID explicitly
-            #     included.
+            #     Required. The name of the model version to be deleted, with a version ID
+            #     explicitly included.
             #
             #     Example: `projects/{project}/locations/{location}/models/{model}@1234`
             #
@@ -1043,7 +1060,8 @@ module Google
             ##
             # Exports a trained, exportable Model to a location specified by the
             # user. A Model is considered to be exportable if it has at least one
-            # {::Google::Cloud::AIPlatform::V1::Model#supported_export_formats supported export format}.
+            # [supported export
+            # format][google.cloud.aiplatform.v1.Model.supported_export_formats].
             #
             # @overload export_model(request, options = nil)
             #   Pass arguments to `export_model` via a request object, either of type
@@ -1431,8 +1449,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListModelEvaluationsResponse#next_page_token ListModelEvaluationsResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::ModelService::Client#list_model_evaluations ModelService.ListModelEvaluations} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListModelEvaluationsResponse#next_page_token ListModelEvaluationsResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::ModelService::Client#list_model_evaluations ModelService.ListModelEvaluations}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #
@@ -1613,8 +1633,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name of the ModelEvaluation to list the ModelEvaluationSlices
-            #     from. Format:
+            #     Required. The resource name of the ModelEvaluation to list the
+            #     ModelEvaluationSlices from. Format:
             #     `projects/{project}/locations/{location}/models/{model}/evaluations/{evaluation}`
             #   @param filter [::String]
             #     The standard list filter.
@@ -1625,8 +1645,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListModelEvaluationSlicesResponse#next_page_token ListModelEvaluationSlicesResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::ModelService::Client#list_model_evaluation_slices ModelService.ListModelEvaluationSlices} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListModelEvaluationSlicesResponse#next_page_token ListModelEvaluationSlicesResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::ModelService::Client#list_model_evaluation_slices ModelService.ListModelEvaluationSlices}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #

data/lib/google/cloud/ai_platform/v1/model_service.rb

@@ -34,7 +34,7 @@ module Google
         ##
         # A service for managing Vertex AI's machine learning Models.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/ai_platform/v1/model_service"
         #     client = ::Google::Cloud::AIPlatform::V1::ModelService::Client.new