google-cloud-ai_platform-v1 0.15.0 → 0.17.0

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

@@ -198,7 +198,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload upload_model(parent: nil, parent_model: nil, model_id: nil, model: nil)
+            # @overload upload_model(parent: nil, parent_model: nil, model_id: nil, model: nil, service_account: nil)
             #   Pass arguments to `upload_model` 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).
@@ -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.
@@ -217,6 +217,14 @@ module Google
             #     `[a-z0-9_-]`. The first character cannot be a number or hyphen.
             #   @param model [::Google::Cloud::AIPlatform::V1::Model, ::Hash]
             #     Required. The Model to create.
+            #   @param service_account [::String]
+            #     Optional. The user-provided custom service account to use to do the model
+            #     upload. If empty, [Vertex AI Service
+            #     Agent](https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents)
+            #     will be used. Users uploading the Model must have the
+            #     `iam.serviceAccounts.actAs` permission on this service account. Also, this
+            #     account must belong to the project specified in the `parent` field and have
+            #     all necessary read permissions.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -412,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
@@ -429,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]
@@ -528,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).
@@ -540,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.
@@ -556,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>]
@@ -667,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]
@@ -736,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
@@ -836,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
@@ -854,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`
             #
@@ -1035,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
@@ -1423,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.
             #
@@ -1605,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.
@@ -1617,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

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

@@ -207,8 +207,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 TrainingPipeline in.
-            #     Format: `projects/{project}/locations/{location}`
+            #     Required. The resource name of the Location to create the TrainingPipeline
+            #     in. Format: `projects/{project}/locations/{location}`
             #   @param training_pipeline [::Google::Cloud::AIPlatform::V1::TrainingPipeline, ::Hash]
             #     Required. The TrainingPipeline to create.
             #
@@ -382,8 +382,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 list the TrainingPipelines from.
-            #     Format: `projects/{project}/locations/{location}`
+            #     Required. The resource name of the Location to list the TrainingPipelines
+            #     from. Format: `projects/{project}/locations/{location}`
             #   @param filter [::String]
             #     The standard list filter.
             #
@@ -410,8 +410,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListTrainingPipelinesResponse#next_page_token ListTrainingPipelinesResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::PipelineService::Client#list_training_pipelines PipelineService.ListTrainingPipelines} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListTrainingPipelinesResponse#next_page_token ListTrainingPipelinesResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::PipelineService::Client#list_training_pipelines PipelineService.ListTrainingPipelines}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #
@@ -585,13 +587,17 @@ module Google
             # Cancels a TrainingPipeline.
             # Starts asynchronous cancellation on the TrainingPipeline. The server
             # makes a best effort to cancel the pipeline, but success is not
-            # guaranteed. Clients can use {::Google::Cloud::AIPlatform::V1::PipelineService::Client#get_training_pipeline PipelineService.GetTrainingPipeline} or
-            # other methods to check whether the cancellation succeeded or whether the
+            # guaranteed. Clients can use
+            # {::Google::Cloud::AIPlatform::V1::PipelineService::Client#get_training_pipeline PipelineService.GetTrainingPipeline}
+            # or other methods to check whether the cancellation succeeded or whether the
             # pipeline completed despite cancellation. On successful cancellation,
             # the TrainingPipeline is not deleted; instead it becomes a pipeline with
-            # a {::Google::Cloud::AIPlatform::V1::TrainingPipeline#error TrainingPipeline.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-            # corresponding to `Code.CANCELLED`, and {::Google::Cloud::AIPlatform::V1::TrainingPipeline#state TrainingPipeline.state} is set to
-            # `CANCELLED`.
+            # a
+            # {::Google::Cloud::AIPlatform::V1::TrainingPipeline#error TrainingPipeline.error}
+            # value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
+            # corresponding to `Code.CANCELLED`, and
+            # {::Google::Cloud::AIPlatform::V1::TrainingPipeline#state TrainingPipeline.state}
+            # is set to `CANCELLED`.
             #
             # @overload cancel_training_pipeline(request, options = nil)
             #   Pass arguments to `cancel_training_pipeline` via a request object, either of type
@@ -920,8 +926,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListPipelineJobsResponse#next_page_token ListPipelineJobsResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::PipelineService::Client#list_pipeline_jobs PipelineService.ListPipelineJobs} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListPipelineJobsResponse#next_page_token ListPipelineJobsResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::PipelineService::Client#list_pipeline_jobs PipelineService.ListPipelineJobs}
+            #     call.
             #   @param order_by [::String]
             #     A comma-separated list of fields to order by. The default sort order is in
             #     ascending order. Use "desc" after a field name for descending. You can have
@@ -1109,12 +1117,15 @@ module Google
             # Cancels a PipelineJob.
             # Starts asynchronous cancellation on the PipelineJob. The server
             # makes a best effort to cancel the pipeline, but success is not
-            # guaranteed. Clients can use {::Google::Cloud::AIPlatform::V1::PipelineService::Client#get_pipeline_job PipelineService.GetPipelineJob} or
-            # other methods to check whether the cancellation succeeded or whether the
+            # guaranteed. Clients can use
+            # {::Google::Cloud::AIPlatform::V1::PipelineService::Client#get_pipeline_job PipelineService.GetPipelineJob}
+            # or other methods to check whether the cancellation succeeded or whether the
             # pipeline completed despite cancellation. On successful cancellation,
             # the PipelineJob is not deleted; instead it becomes a pipeline with
-            # a {::Google::Cloud::AIPlatform::V1::PipelineJob#error PipelineJob.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-            # corresponding to `Code.CANCELLED`, and {::Google::Cloud::AIPlatform::V1::PipelineJob#state PipelineJob.state} is set to
+            # a {::Google::Cloud::AIPlatform::V1::PipelineJob#error PipelineJob.error} value
+            # with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding
+            # to `Code.CANCELLED`, and
+            # {::Google::Cloud::AIPlatform::V1::PipelineJob#state PipelineJob.state} is set to
             # `CANCELLED`.
             #
             # @overload cancel_pipeline_job(request, options = nil)

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

@@ -36,7 +36,7 @@ module Google
         # `TrainingPipeline` resources (used for AutoML and custom training) and
         # `PipelineJob` resources (used for Vertex AI Pipelines).
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/ai_platform/v1/pipeline_service"
         #     client = ::Google::Cloud::AIPlatform::V1::PipelineService::Client.new

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

@@ -206,7 +206,8 @@ module Google
             #     {::Google::Cloud::AIPlatform::V1::PredictSchemata#instance_schema_uri instance_schema_uri}.
             #   @param parameters [::Google::Protobuf::Value, ::Hash]
             #     The parameters that govern the prediction. The schema of the parameters may
-            #     be specified via Endpoint's DeployedModels' [Model's ][google.cloud.aiplatform.v1.DeployedModel.model]
+            #     be specified via Endpoint's DeployedModels' [Model's
+            #     ][google.cloud.aiplatform.v1.DeployedModel.model]
             #     [PredictSchemata's][google.cloud.aiplatform.v1.Model.predict_schemata]
             #     {::Google::Cloud::AIPlatform::V1::PredictSchemata#parameters_schema_uri parameters_schema_uri}.
             #
@@ -279,11 +280,13 @@ module Google
             #
             # The response includes the following HTTP headers:
             #
-            # * `X-Vertex-AI-Endpoint-Id`: ID of the {::Google::Cloud::AIPlatform::V1::Endpoint Endpoint} that served this
+            # * `X-Vertex-AI-Endpoint-Id`: ID of the
+            # {::Google::Cloud::AIPlatform::V1::Endpoint Endpoint} that served this
             # prediction.
             #
-            # * `X-Vertex-AI-Deployed-Model-Id`: ID of the Endpoint's {::Google::Cloud::AIPlatform::V1::DeployedModel DeployedModel}
-            # that served this prediction.
+            # * `X-Vertex-AI-Deployed-Model-Id`: ID of the Endpoint's
+            # {::Google::Cloud::AIPlatform::V1::DeployedModel DeployedModel} that served this
+            # prediction.
             #
             # @overload raw_predict(request, options = nil)
             #   Pass arguments to `raw_predict` via a request object, either of type
@@ -307,16 +310,18 @@ module Google
             #   @param http_body [::Google::Api::HttpBody, ::Hash]
             #     The prediction input. Supports HTTP headers and arbitrary data payload.
             #
-            #     A {::Google::Cloud::AIPlatform::V1::DeployedModel DeployedModel} may have an upper limit on the number of instances it
-            #     supports per request. When this limit it is exceeded for an AutoML model,
-            #     the {::Google::Cloud::AIPlatform::V1::PredictionService::Client#raw_predict RawPredict} method returns an error.
-            #     When this limit is exceeded for a custom-trained model, the behavior varies
-            #     depending on the model.
+            #     A {::Google::Cloud::AIPlatform::V1::DeployedModel DeployedModel} may have an
+            #     upper limit on the number of instances it supports per request. When this
+            #     limit it is exceeded for an AutoML model, the
+            #     {::Google::Cloud::AIPlatform::V1::PredictionService::Client#raw_predict RawPredict}
+            #     method returns an error. When this limit is exceeded for a custom-trained
+            #     model, the behavior varies depending on the model.
             #
             #     You can specify the schema for each instance in the
             #     {::Google::Cloud::AIPlatform::V1::PredictSchemata#instance_schema_uri predict_schemata.instance_schema_uri}
-            #     field when you create a {::Google::Cloud::AIPlatform::V1::Model Model}. This schema applies when you deploy the
-            #     `Model` as a `DeployedModel` to an {::Google::Cloud::AIPlatform::V1::Endpoint Endpoint} and use the `RawPredict`
+            #     field when you create a {::Google::Cloud::AIPlatform::V1::Model Model}. This
+            #     schema applies when you deploy the `Model` as a `DeployedModel` to an
+            #     {::Google::Cloud::AIPlatform::V1::Endpoint Endpoint} and use the `RawPredict`
             #     method.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -386,10 +391,12 @@ module Google
             ##
             # Perform an online explanation.
             #
-            # If {::Google::Cloud::AIPlatform::V1::ExplainRequest#deployed_model_id deployed_model_id} is specified,
-            # the corresponding DeployModel must have
+            # If
+            # {::Google::Cloud::AIPlatform::V1::ExplainRequest#deployed_model_id deployed_model_id}
+            # is specified, the corresponding DeployModel must have
             # {::Google::Cloud::AIPlatform::V1::DeployedModel#explanation_spec explanation_spec}
-            # populated. If {::Google::Cloud::AIPlatform::V1::ExplainRequest#deployed_model_id deployed_model_id}
+            # populated. If
+            # {::Google::Cloud::AIPlatform::V1::ExplainRequest#deployed_model_id deployed_model_id}
             # is not specified, all DeployedModels must have
             # {::Google::Cloud::AIPlatform::V1::DeployedModel#explanation_spec explanation_spec}
             # populated. Only deployed AutoML tabular Models have
@@ -426,21 +433,23 @@ module Google
             #     {::Google::Cloud::AIPlatform::V1::PredictSchemata#instance_schema_uri instance_schema_uri}.
             #   @param parameters [::Google::Protobuf::Value, ::Hash]
             #     The parameters that govern the prediction. The schema of the parameters may
-            #     be specified via Endpoint's DeployedModels' [Model's ][google.cloud.aiplatform.v1.DeployedModel.model]
+            #     be specified via Endpoint's DeployedModels' [Model's
+            #     ][google.cloud.aiplatform.v1.DeployedModel.model]
             #     [PredictSchemata's][google.cloud.aiplatform.v1.Model.predict_schemata]
             #     {::Google::Cloud::AIPlatform::V1::PredictSchemata#parameters_schema_uri parameters_schema_uri}.
             #   @param explanation_spec_override [::Google::Cloud::AIPlatform::V1::ExplanationSpecOverride, ::Hash]
             #     If specified, overrides the
-            #     {::Google::Cloud::AIPlatform::V1::DeployedModel#explanation_spec explanation_spec} of the DeployedModel.
-            #     Can be used for explaining prediction results with different
-            #     configurations, such as:
+            #     {::Google::Cloud::AIPlatform::V1::DeployedModel#explanation_spec explanation_spec}
+            #     of the DeployedModel. Can be used for explaining prediction results with
+            #     different configurations, such as:
             #      - Explaining top-5 predictions results as opposed to top-1;
             #      - Increasing path count or step count of the attribution methods to reduce
             #        approximate errors;
             #      - Using different baselines for explaining the prediction results.
             #   @param deployed_model_id [::String]
             #     If specified, this ExplainRequest will be served by the chosen
-            #     DeployedModel, overriding {::Google::Cloud::AIPlatform::V1::Endpoint#traffic_split Endpoint.traffic_split}.
+            #     DeployedModel, overriding
+            #     {::Google::Cloud::AIPlatform::V1::Endpoint#traffic_split Endpoint.traffic_split}.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::ExplainResponse]

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

@@ -33,7 +33,7 @@ module Google
         ##
         # A service for online predictions and explanations.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/ai_platform/v1/prediction_service"
         #     client = ::Google::Cloud::AIPlatform::V1::PredictionService::Client.new

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

@@ -398,9 +398,11 @@ module Google
             #     The standard list page size.
             #   @param page_token [::String]
             #     The standard list page token.
-            #     Typically obtained by {::Google::Cloud::AIPlatform::V1::ListSpecialistPoolsResponse#next_page_token ListSpecialistPoolsResponse.next_page_token} of
-            #     the previous {::Google::Cloud::AIPlatform::V1::SpecialistPoolService::Client#list_specialist_pools SpecialistPoolService.ListSpecialistPools} call. Return
-            #     first page if empty.
+            #     Typically obtained by
+            #     {::Google::Cloud::AIPlatform::V1::ListSpecialistPoolsResponse#next_page_token ListSpecialistPoolsResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::SpecialistPoolService::Client#list_specialist_pools SpecialistPoolService.ListSpecialistPools}
+            #     call. Return first page if empty.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read. FieldMask represents a set of
             #