google-cloud-ai_platform-v1 0.22.0 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c1062351f3dbc02b36511198731b9f24ca91e93dc229861cb271eca58ec2fa1
-  data.tar.gz: ce36f47cdb282c320f98e08bb4db0ffd5e1b5f5c0d53bed572c0799c19498319
+  metadata.gz: e4fb9d2c0c08f62d6c6e350e8067e9a771da919c7c3465092afd576e7d94f159
+  data.tar.gz: 4e997cf49e37e81613dcaf4ad0aa887c07ff65524c2400b8121ab059ac6a17ac
 SHA512:
-  metadata.gz: 92a1c9fa7e0d62d1a8686e56e0fa5123feccb6e7f43de2618488d16b44a97b5c67d8eade6a010ff7352c45836e8e9972b95d913d2dee89909c71a2189aea2aa1
-  data.tar.gz: efd9bd50226ef911dc549e2ee721d892fe9312839fdbb020c57783e602339842c7248628c619e2270c05be1d2db94c2ea3c041adb5f3a9486c580cf77119401b
+  metadata.gz: c6cdd0917326e4ce3681327bfdd7fc81f0b274bc810a00a05863115f8d4bc192d901b55119c34d262758d1328eb59e6a73285731efdfd405b5c7af84ba53068b
+  data.tar.gz: 636944fb0edbe7846bf0354bafb5f7af97d87b856c4d68c5a0f6668b3e1a15e1d79bbe8878337b3ad85c5822f0e502f9954938ea29092603e3850b27996d9c63

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

@@ -915,6 +915,120 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Updates an existing deployed model. Updatable fields include
+            # `min_replica_count`, `max_replica_count`, `autoscaling_metric_specs`,
+            # `disable_container_logging` (v1 only), and `enable_container_logging`
+            # (v1beta1 only).
+            #
+            # @overload mutate_deployed_model(request, options = nil)
+            #   Pass arguments to `mutate_deployed_model` via a request object, either of type
+            #   {::Google::Cloud::AIPlatform::V1::MutateDeployedModelRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::AIPlatform::V1::MutateDeployedModelRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload mutate_deployed_model(endpoint: nil, deployed_model: nil, update_mask: nil)
+            #   Pass arguments to `mutate_deployed_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).
+            #
+            #   @param endpoint [::String]
+            #     Required. The name of the Endpoint resource into which to mutate a
+            #     DeployedModel. Format:
+            #     `projects/{project}/locations/{location}/endpoints/{endpoint}`
+            #   @param deployed_model [::Google::Cloud::AIPlatform::V1::DeployedModel, ::Hash]
+            #     Required. The DeployedModel to be mutated within the Endpoint. Only the
+            #     following fields can be mutated:
+            #
+            #     * `min_replica_count` in either
+            #     {::Google::Cloud::AIPlatform::V1::DedicatedResources DedicatedResources} or
+            #     {::Google::Cloud::AIPlatform::V1::AutomaticResources AutomaticResources}
+            #     * `max_replica_count` in either
+            #     {::Google::Cloud::AIPlatform::V1::DedicatedResources DedicatedResources} or
+            #     {::Google::Cloud::AIPlatform::V1::AutomaticResources AutomaticResources}
+            #     * {::Google::Cloud::AIPlatform::V1::DedicatedResources#autoscaling_metric_specs autoscaling_metric_specs}
+            #     * `disable_container_logging` (v1 only)
+            #     * `enable_container_logging` (v1beta1 only)
+            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+            #     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 [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/ai_platform/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::AIPlatform::V1::EndpointService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::AIPlatform::V1::MutateDeployedModelRequest.new
+            #
+            #   # Call the mutate_deployed_model method.
+            #   result = client.mutate_deployed_model request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "No response received."
+            #   end
+            #
+            def mutate_deployed_model request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AIPlatform::V1::MutateDeployedModelRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.mutate_deployed_model.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::AIPlatform::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.endpoint
+                header_params["endpoint"] = request.endpoint
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.mutate_deployed_model.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.mutate_deployed_model.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @endpoint_service_stub.call_rpc :mutate_deployed_model, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the EndpointService API.
             #
@@ -1085,6 +1199,11 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :undeploy_model
+                ##
+                # RPC-specific configuration for `mutate_deployed_model`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :mutate_deployed_model
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -1102,6 +1221,8 @@ module Google
                   @deploy_model = ::Gapic::Config::Method.new deploy_model_config
                   undeploy_model_config = parent_rpcs.undeploy_model if parent_rpcs.respond_to? :undeploy_model
                   @undeploy_model = ::Gapic::Config::Method.new undeploy_model_config
+                  mutate_deployed_model_config = parent_rpcs.mutate_deployed_model if parent_rpcs.respond_to? :mutate_deployed_model
+                  @mutate_deployed_model = ::Gapic::Config::Method.new mutate_deployed_model_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/ai_platform/v1/endpoint_service/paths.rb

@@ -27,20 +27,46 @@ module Google
             ##
             # Create a fully-qualified Endpoint resource string.
             #
-            # The resource will be in the following format:
+            # @overload endpoint_path(project:, location:, endpoint:)
+            #   The resource will be in the following format:
             #
-            # `projects/{project}/locations/{location}/endpoints/{endpoint}`
+            #   `projects/{project}/locations/{location}/endpoints/{endpoint}`
             #
-            # @param project [String]
-            # @param location [String]
-            # @param endpoint [String]
+            #   @param project [String]
+            #   @param location [String]
+            #   @param endpoint [String]
+            #
+            # @overload endpoint_path(project:, location:, publisher:, model:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param publisher [String]
+            #   @param model [String]
             #
             # @return [::String]
-            def endpoint_path project:, location:, endpoint:
-              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
-              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+            def endpoint_path **args
+              resources = {
+                "endpoint:location:project" => (proc do |project:, location:, endpoint:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/endpoints/#{endpoint}"
+                end),
+                "location:model:project:publisher" => (proc do |project:, location:, publisher:, model:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "publisher cannot contain /" if publisher.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/publishers/#{publisher}/models/#{model}"
+                end)
+              }
 
-              "projects/#{project}/locations/#{location}/endpoints/#{endpoint}"
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
             end
 
             ##

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

@@ -546,7 +546,7 @@ module Google
             #       * `labels`
             #       * `online_serving_config.fixed_node_count`
             #       * `online_serving_config.scaling`
-            #       * `online_storage_ttl_days` (available in Preview)
+            #       * `online_storage_ttl_days`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -1089,7 +1089,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)
+            #       * `offline_storage_ttl_days`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::EntityType]

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

@@ -43,6 +43,27 @@ module Google
               "projects/#{project}/locations/#{location}/batchPredictionJobs/#{batch_prediction_job}"
             end
 
+            ##
+            # Create a fully-qualified Context resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/metadataStores/{metadata_store}/contexts/{context}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param metadata_store [String]
+            # @param context [String]
+            #
+            # @return [::String]
+            def context_path project:, location:, metadata_store:, context:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "metadata_store cannot contain /" if metadata_store.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/metadataStores/#{metadata_store}/contexts/#{context}"
+            end
+
             ##
             # Create a fully-qualified CustomJob resource string.
             #
@@ -103,20 +124,46 @@ module Google
             ##
             # Create a fully-qualified Endpoint resource string.
             #
-            # The resource will be in the following format:
+            # @overload endpoint_path(project:, location:, endpoint:)
+            #   The resource will be in the following format:
             #
-            # `projects/{project}/locations/{location}/endpoints/{endpoint}`
+            #   `projects/{project}/locations/{location}/endpoints/{endpoint}`
             #
-            # @param project [String]
-            # @param location [String]
-            # @param endpoint [String]
+            #   @param project [String]
+            #   @param location [String]
+            #   @param endpoint [String]
+            #
+            # @overload endpoint_path(project:, location:, publisher:, model:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param publisher [String]
+            #   @param model [String]
             #
             # @return [::String]
-            def endpoint_path project:, location:, endpoint:
-              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
-              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
-
-              "projects/#{project}/locations/#{location}/endpoints/#{endpoint}"
+            def endpoint_path **args
+              resources = {
+                "endpoint:location:project" => (proc do |project:, location:, endpoint:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/endpoints/#{endpoint}"
+                end),
+                "location:model:project:publisher" => (proc do |project:, location:, publisher:, model:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "publisher cannot contain /" if publisher.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/publishers/#{publisher}/models/#{model}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
             end
 
             ##