google-cloud-ai_platform-v1 0.15.0 → 0.17.0

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

@@ -210,8 +210,8 @@ module Google
             #   @param featurestore [::Google::Cloud::AIPlatform::V1::Featurestore, ::Hash]
             #     Required. The Featurestore to create.
             #   @param featurestore_id [::String]
-            #     Required. The ID to use for this Featurestore, which will become the final component
-            #     of the Featurestore's resource name.
+            #     Required. The ID to use for this Featurestore, which will become the final
+            #     component of the Featurestore's resource name.
             #
             #     This value may be up to 60 characters, and valid characters are
             #     `[a-z0-9_]`. The first character cannot be a number.
@@ -424,12 +424,12 @@ module Google
             #     coerced to 100.
             #   @param page_token [::String]
             #     A page token, received from a previous
-            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_featurestores FeaturestoreService.ListFeaturestores} call.
-            #     Provide this to retrieve the subsequent page.
+            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_featurestores FeaturestoreService.ListFeaturestores}
+            #     call. Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other parameters provided to
-            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_featurestores FeaturestoreService.ListFeaturestores} must
-            #     match the call that provided the page token.
+            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_featurestores FeaturestoreService.ListFeaturestores}
+            #     must match the call that provided the page token.
             #   @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.
@@ -531,9 +531,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param featurestore [::Google::Cloud::AIPlatform::V1::Featurestore, ::Hash]
-            #     Required. The Featurestore's `name` field is used to identify the Featurestore to be
-            #     updated.
-            #     Format:
+            #     Required. The Featurestore's `name` field is used to identify the
+            #     Featurestore to be updated. Format:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}`
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Field mask is used to specify the fields to be overwritten in the
@@ -549,6 +548,7 @@ module Google
             #       * `labels`
             #       * `online_serving_config.fixed_node_count`
             #       * `online_serving_config.scaling`
+            #       * `online_storage_ttl_days` (available in Preview)
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -747,8 +747,8 @@ module Google
             #   @param entity_type [::Google::Cloud::AIPlatform::V1::EntityType, ::Hash]
             #     The EntityType to create.
             #   @param entity_type_id [::String]
-            #     Required. The ID to use for the EntityType, which will become the final component of
-            #     the EntityType's resource name.
+            #     Required. The ID to use for the EntityType, which will become the final
+            #     component of the EntityType's resource name.
             #
             #     This value may be up to 60 characters, and valid characters are
             #     `[a-z0-9_]`. The first character cannot be a number.
@@ -962,12 +962,12 @@ module Google
             #     1000.
             #   @param page_token [::String]
             #     A page token, received from a previous
-            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_entity_types FeaturestoreService.ListEntityTypes} call.
-            #     Provide this to retrieve the subsequent page.
+            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_entity_types FeaturestoreService.ListEntityTypes}
+            #     call. Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other parameters provided to
-            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_entity_types FeaturestoreService.ListEntityTypes} must
-            #     match the call that provided the page token.
+            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_entity_types FeaturestoreService.ListEntityTypes}
+            #     must match the call that provided the page token.
             #   @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.
@@ -1070,9 +1070,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param entity_type [::Google::Cloud::AIPlatform::V1::EntityType, ::Hash]
-            #     Required. The EntityType's `name` field is used to identify the EntityType to be
-            #     updated.
-            #     Format:
+            #     Required. The EntityType's `name` field is used to identify the EntityType
+            #     to be updated. Format:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Field mask is used to specify the fields to be overwritten in the
@@ -1094,6 +1093,7 @@ module Google
             #       * `monitoring_config.import_features_analysis.anomaly_detection_baseline`
             #       * `monitoring_config.numerical_threshold_config.value`
             #       * `monitoring_config.categorical_threshold_config.value`
+            #       * `offline_storage_ttl_days` (available in Preview)
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::EntityType]
@@ -1283,8 +1283,8 @@ module Google
             #   @param feature [::Google::Cloud::AIPlatform::V1::Feature, ::Hash]
             #     Required. The Feature to create.
             #   @param feature_id [::String]
-            #     Required. The ID to use for the Feature, which will become the final component of
-            #     the Feature's resource name.
+            #     Required. The ID to use for the Feature, which will become the final
+            #     component of the Feature's resource name.
             #
             #     This value may be up to 128 characters, and valid characters are
             #     `[a-z0-9_]`. The first character cannot be a number.
@@ -1382,14 +1382,15 @@ 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 EntityType to create the batch of Features under.
-            #     Format:
+            #     Required. The resource name of the EntityType to create the batch of
+            #     Features under. Format:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
             #   @param requests [::Array<::Google::Cloud::AIPlatform::V1::CreateFeatureRequest, ::Hash>]
-            #     Required. The request message specifying the Features to create. All Features must be
-            #     created under the same parent EntityType. The `parent` field in each child
-            #     request message can be omitted. If `parent` is set in a child request, then
-            #     the value must match the `parent` value in this request message.
+            #     Required. The request message specifying the Features to create. All
+            #     Features must be created under the same parent EntityType. The `parent`
+            #     field in each child request message can be omitted. If `parent` is set in a
+            #     child request, then the value must match the `parent` value in this request
+            #     message.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -1600,12 +1601,12 @@ module Google
             #     1000.
             #   @param page_token [::String]
             #     A page token, received from a previous
-            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_features FeaturestoreService.ListFeatures} call.
-            #     Provide this to retrieve the subsequent page.
+            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_features FeaturestoreService.ListFeatures}
+            #     call. Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other parameters provided to
-            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_features FeaturestoreService.ListFeatures} must
-            #     match the call that provided the page token.
+            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_features FeaturestoreService.ListFeatures}
+            #     must match the call that provided the page token.
             #   @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.
@@ -1618,10 +1619,12 @@ module Google
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #   @param latest_stats_count [::Integer]
-            #     If set, return the most recent {::Google::Cloud::AIPlatform::V1::ListFeaturesRequest#latest_stats_count ListFeaturesRequest.latest_stats_count}
+            #     If set, return the most recent
+            #     {::Google::Cloud::AIPlatform::V1::ListFeaturesRequest#latest_stats_count ListFeaturesRequest.latest_stats_count}
             #     of stats for each Feature in response. Valid value is [0, 10]. If number of
-            #     stats exists < {::Google::Cloud::AIPlatform::V1::ListFeaturesRequest#latest_stats_count ListFeaturesRequest.latest_stats_count}, return all
-            #     existing stats.
+            #     stats exists <
+            #     {::Google::Cloud::AIPlatform::V1::ListFeaturesRequest#latest_stats_count ListFeaturesRequest.latest_stats_count},
+            #     return all existing stats.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::AIPlatform::V1::Feature>]
@@ -1938,16 +1941,16 @@ module Google
             #     Single Feature timestamp for all entities being imported. The
             #     timestamp must not have higher than millisecond precision.
             #   @param entity_type [::String]
-            #     Required. The resource name of the EntityType grouping the Features for which values
-            #     are being imported. Format:
+            #     Required. The resource name of the EntityType grouping the Features for
+            #     which values are being imported. Format:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`
             #   @param entity_id_field [::String]
             #     Source column that holds entity IDs. If not provided, entity IDs are
             #     extracted from the column named `entity_id`.
             #   @param feature_specs [::Array<::Google::Cloud::AIPlatform::V1::ImportFeatureValuesRequest::FeatureSpec, ::Hash>]
-            #     Required. Specifications defining which Feature values to import from the entity. The
-            #     request fails if no feature_specs are provided, and having multiple
-            #     feature_specs for one Feature is not allowed.
+            #     Required. Specifications defining which Feature values to import from the
+            #     entity. The request fails if no feature_specs are provided, and having
+            #     multiple feature_specs for one Feature is not allowed.
             #   @param disable_online_serving [::Boolean]
             #     If set, data will not be imported for online serving. This
             #     is typically used for backfilling, where Feature generation timestamps are
@@ -2085,8 +2088,8 @@ module Google
             #   @param bigquery_read_instances [::Google::Cloud::AIPlatform::V1::BigQuerySource, ::Hash]
             #     Similar to csv_read_instances, but from BigQuery source.
             #   @param featurestore [::String]
-            #     Required. The resource name of the Featurestore from which to query Feature values.
-            #     Format:
+            #     Required. The resource name of the Featurestore from which to query Feature
+            #     values. Format:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}`
             #   @param destination [::Google::Cloud::AIPlatform::V1::FeatureValueDestination, ::Hash]
             #     Required. Specifies output location and format.
@@ -2099,14 +2102,14 @@ module Google
             #     automatically inferred. For CSV source, the pass-through values will be
             #     passed as opaque bytes.
             #   @param entity_type_specs [::Array<::Google::Cloud::AIPlatform::V1::BatchReadFeatureValuesRequest::EntityTypeSpec, ::Hash>]
-            #     Required. Specifies EntityType grouping Features to read values of and settings.
-            #     Each EntityType referenced in
+            #     Required. Specifies EntityType grouping Features to read values of and
+            #     settings. Each EntityType referenced in
             #     [BatchReadFeatureValuesRequest.entity_type_specs] must have a column
             #     specifying entity IDs in the EntityType in
             #     [BatchReadFeatureValuesRequest.request][] .
             #   @param start_time [::Google::Protobuf::Timestamp, ::Hash]
-            #     Optional. Excludes Feature values with feature generation timestamp before this
-            #     timestamp. If not set, retrieve oldest values kept in Feature Store.
+            #     Optional. Excludes Feature values with feature generation timestamp before
+            #     this timestamp. If not set, retrieve oldest values kept in Feature Store.
             #     Timestamp, if present, must not have higher than millisecond precision.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -2206,8 +2209,8 @@ module Google
             #     Exports all historical values of all entities of the EntityType within a
             #     time range
             #   @param entity_type [::String]
-            #     Required. The resource name of the EntityType from which to export Feature values.
-            #     Format:
+            #     Required. The resource name of the EntityType from which to export Feature
+            #     values. Format:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
             #   @param destination [::Google::Cloud::AIPlatform::V1::FeatureValueDestination, ::Hash]
             #     Required. Specifies destination location and format.
@@ -2377,12 +2380,12 @@ module Google
             #     100.
             #   @param page_token [::String]
             #     A page token, received from a previous
-            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#search_features FeaturestoreService.SearchFeatures} call.
-            #     Provide this to retrieve the subsequent page.
+            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#search_features FeaturestoreService.SearchFeatures}
+            #     call. Provide this to retrieve the subsequent page.
             #
             #     When paginating, all other parameters provided to
-            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#search_features FeaturestoreService.SearchFeatures}, except `page_size`, must
-            #     match the call that provided the page token.
+            #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#search_features FeaturestoreService.SearchFeatures},
+            #     except `page_size`, must match the call that provided the page token.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::AIPlatform::V1::Feature>]

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

@@ -34,7 +34,7 @@ module Google
         ##
         # The service that handles CRUD and List for resources for Featurestore.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/ai_platform/v1/featurestore_service"
         #     client = ::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client.new

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

@@ -387,11 +387,11 @@ 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 from which to list the IndexEndpoints.
-            #     Format: `projects/{project}/locations/{location}`
+            #     Required. The resource name of the Location from which to list the
+            #     IndexEndpoints. Format: `projects/{project}/locations/{location}`
             #   @param filter [::String]
-            #     Optional. An expression for filtering the results of the request. For field names
-            #     both snake_case and camelCase are supported.
+            #     Optional. An expression for filtering the results of the request. For field
+            #     names both snake_case and camelCase are supported.
             #
             #       * `index_endpoint` supports = and !=. `index_endpoint` represents the
             #          IndexEndpoint ID, ie. the last segment of the IndexEndpoint's
@@ -413,8 +413,10 @@ module Google
             #   @param page_token [::String]
             #     Optional. The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListIndexEndpointsResponse#next_page_token ListIndexEndpointsResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::IndexEndpointService::Client#list_index_endpoints IndexEndpointService.ListIndexEndpoints} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListIndexEndpointsResponse#next_page_token ListIndexEndpointsResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::IndexEndpointService::Client#list_index_endpoints IndexEndpointService.ListIndexEndpoints}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Optional. Mask specifying which fields to read.
             #
@@ -510,7 +512,8 @@ module Google
             #   @param index_endpoint [::Google::Cloud::AIPlatform::V1::IndexEndpoint, ::Hash]
             #     Required. The IndexEndpoint which replaces the resource on the server.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The update mask applies to the resource. See {::Google::Protobuf::FieldMask google.protobuf.FieldMask}.
+            #     Required. The update mask applies to the resource. See
+            #     {::Google::Protobuf::FieldMask google.protobuf.FieldMask}.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::IndexEndpoint]
@@ -692,8 +695,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param index_endpoint [::String]
-            #     Required. The name of the IndexEndpoint resource into which to deploy an Index.
-            #     Format:
+            #     Required. The name of the IndexEndpoint resource into which to deploy an
+            #     Index. Format:
             #     `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`
             #   @param deployed_index [::Google::Cloud::AIPlatform::V1::DeployedIndex, ::Hash]
             #     Required. The DeployedIndex to be created within the IndexEndpoint.
@@ -790,11 +793,12 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param index_endpoint [::String]
-            #     Required. The name of the IndexEndpoint resource from which to undeploy an Index.
-            #     Format:
+            #     Required. The name of the IndexEndpoint resource from which to undeploy an
+            #     Index. Format:
             #     `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`
             #   @param deployed_index_id [::String]
-            #     Required. The ID of the DeployedIndex to be undeployed from the IndexEndpoint.
+            #     Required. The ID of the DeployedIndex to be undeployed from the
+            #     IndexEndpoint.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -887,8 +891,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param index_endpoint [::String]
-            #     Required. The name of the IndexEndpoint resource into which to deploy an Index.
-            #     Format:
+            #     Required. The name of the IndexEndpoint resource into which to deploy an
+            #     Index. Format:
             #     `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`
             #   @param deployed_index [::Google::Cloud::AIPlatform::V1::DeployedIndex, ::Hash]
             #     Required. The DeployedIndex to be updated within the IndexEndpoint.

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

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

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

@@ -396,8 +396,10 @@ module Google
             #   @param page_token [::String]
             #     The standard list page token.
             #     Typically obtained via
-            #     {::Google::Cloud::AIPlatform::V1::ListIndexesResponse#next_page_token ListIndexesResponse.next_page_token} of the previous
-            #     {::Google::Cloud::AIPlatform::V1::IndexService::Client#list_indexes IndexService.ListIndexes} call.
+            #     {::Google::Cloud::AIPlatform::V1::ListIndexesResponse#next_page_token ListIndexesResponse.next_page_token}
+            #     of the previous
+            #     {::Google::Cloud::AIPlatform::V1::IndexService::Client#list_indexes IndexService.ListIndexes}
+            #     call.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #
@@ -494,7 +496,8 @@ module Google
             #     Required. The Index which updates the resource on the server.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     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 [::Gapic::Operation]
@@ -571,7 +574,8 @@ module Google
             ##
             # Deletes an Index.
             # An Index can only be deleted when all its
-            # {::Google::Cloud::AIPlatform::V1::Index#deployed_indexes DeployedIndexes} had been undeployed.
+            # {::Google::Cloud::AIPlatform::V1::Index#deployed_indexes DeployedIndexes} had
+            # been undeployed.
             #
             # @overload delete_index(request, options = nil)
             #   Pass arguments to `delete_index` via a request object, either of type

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

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

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