google-cloud-ai_platform-v1 0.33.0 → 0.35.0

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

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module AIPlatform
+      module V1
+        module FeatureRegistryService
+          # Path helper methods for the FeatureRegistryService API.
+          module Paths
+            ##
+            # Create a fully-qualified EntityType resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param featurestore [String]
+            # @param entity_type [String]
+            #
+            # @return [::String]
+            def entity_type_path project:, location:, featurestore:, entity_type:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "featurestore cannot contain /" if featurestore.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/featurestores/#{featurestore}/entityTypes/#{entity_type}"
+            end
+
+            ##
+            # Create a fully-qualified Feature resource string.
+            #
+            # @overload feature_path(project:, location:, featurestore:, entity_type:, feature:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param featurestore [String]
+            #   @param entity_type [String]
+            #   @param feature [String]
+            #
+            # @overload feature_path(project:, location:, feature_group:, feature:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param feature_group [String]
+            #   @param feature [String]
+            #
+            # @return [::String]
+            def feature_path **args
+              resources = {
+                "entity_type:feature:featurestore:location:project" => (proc do |project:, location:, featurestore:, entity_type:, feature:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "featurestore cannot contain /" if featurestore.to_s.include? "/"
+                  raise ::ArgumentError, "entity_type cannot contain /" if entity_type.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/featurestores/#{featurestore}/entityTypes/#{entity_type}/features/#{feature}"
+                end),
+                "feature:feature_group:location:project" => (proc do |project:, location:, feature_group:, feature:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "feature_group cannot contain /" if feature_group.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/featureGroups/#{feature_group}/features/#{feature}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
+            ##
+            # Create a fully-qualified FeatureGroup resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/featureGroups/{feature_group}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param feature_group [String]
+            #
+            # @return [::String]
+            def feature_group_path project:, location:, feature_group:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/featureGroups/#{feature_group}"
+            end
+
+            ##
+            # Create a fully-qualified Location resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}`
+            #
+            # @param project [String]
+            # @param location [String]
+            #
+            # @return [::String]
+            def location_path project:, location:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}"
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/ai_platform/v1/version"
+
+require "google/cloud/ai_platform/v1/feature_registry_service/credentials"
+require "google/cloud/ai_platform/v1/feature_registry_service/paths"
+require "google/cloud/ai_platform/v1/feature_registry_service/operations"
+require "google/cloud/ai_platform/v1/feature_registry_service/client"
+
+module Google
+  module Cloud
+    module AIPlatform
+      module V1
+        ##
+        # The service that handles CRUD and List for resources for
+        # FeatureRegistry.
+        #
+        # @example Load this service and instantiate a gRPC client
+        #
+        #     require "google/cloud/ai_platform/v1/feature_registry_service"
+        #     client = ::Google::Cloud::AIPlatform::V1::FeatureRegistryService::Client.new
+        #
+        module FeatureRegistryService
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "feature_registry_service", "helpers.rb"
+require "google/cloud/ai_platform/v1/feature_registry_service/helpers" if ::File.file? helper_path

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

@@ -1274,9 +1274,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 EntityType to create a Feature.
-            #     Format:
+            #     Required. The resource name of the EntityType or FeatureGroup to create a
+            #     Feature. Format for entity_type as parent:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
+            #     Format for feature_group as parent:
+            #     `projects/{project}/locations/{location}/featureGroups/{feature_group}`
             #   @param feature [::Google::Cloud::AIPlatform::V1::Feature, ::Hash]
             #     Required. The Feature to create.
             #   @param feature_id [::String]
@@ -1286,7 +1288,7 @@ module Google
             #     This value may be up to 128 characters, and valid characters are
             #     `[a-z0-9_]`. The first character cannot be a number.
             #
-            #     The value must be unique within an EntityType.
+            #     The value must be unique within an EntityType/FeatureGroup.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -1481,8 +1483,10 @@ module Google
             #
             #   @param name [::String]
             #     Required. The name of the Feature resource.
-            #     Format:
+            #     Format for entity_type as parent:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
+            #     Format for feature_group as parent:
+            #     `projects/{project}/locations/{location}/featureGroups/{feature_group}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::Feature]
@@ -1568,8 +1572,10 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The resource name of the Location to list Features.
-            #     Format:
+            #     Format for entity_type as parent:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
+            #     Format for feature_group as parent:
+            #     `projects/{project}/locations/{location}/featureGroups/{feature_group}`
             #   @param filter [::String]
             #     Lists the Features that match the filter expression. The following
             #     filters are supported:
@@ -1599,10 +1605,14 @@ module Google
             #   @param page_token [::String]
             #     A page token, received from a previous
             #     {::Google::Cloud::AIPlatform::V1::FeaturestoreService::Client#list_features FeaturestoreService.ListFeatures}
+            #     call or
+            #     {::Google::Cloud::AIPlatform::V1::FeatureRegistryService::Client#list_features FeatureRegistryService.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}
+            #     or or
+            #     {::Google::Cloud::AIPlatform::V1::FeatureRegistryService::Client#list_features FeatureRegistryService.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.
@@ -1610,12 +1620,13 @@ module Google
             #     Supported fields:
             #
             #       * `feature_id`
-            #       * `value_type`
+            #       * `value_type` (Not supported for FeatureRegistry Feature)
             #       * `create_time`
             #       * `update_time`
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Mask specifying which fields to read.
             #   @param latest_stats_count [::Integer]
+            #     Only applicable for Vertex AI Feature Store (Legacy).
             #     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
@@ -1715,6 +1726,7 @@ module Google
             #     updated.
             #     Format:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}`
+            #     `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Field mask is used to specify the fields to be overwritten in the
             #     Features resource by the update.
@@ -1728,7 +1740,7 @@ module Google
             #
             #       * `description`
             #       * `labels`
-            #       * `disable_monitoring`
+            #       * `disable_monitoring` (Not supported for FeatureRegistry Feature)
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::AIPlatform::V1::Feature]
@@ -1816,6 +1828,7 @@ module Google
             #     Required. The name of the Features to be deleted.
             #     Format:
             #     `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}`
+            #     `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]

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

@@ -48,24 +48,69 @@ module Google
             ##
             # Create a fully-qualified Feature resource string.
             #
+            # @overload feature_path(project:, location:, featurestore:, entity_type:, feature:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param featurestore [String]
+            #   @param entity_type [String]
+            #   @param feature [String]
+            #
+            # @overload feature_path(project:, location:, feature_group:, feature:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param feature_group [String]
+            #   @param feature [String]
+            #
+            # @return [::String]
+            def feature_path **args
+              resources = {
+                "entity_type:feature:featurestore:location:project" => (proc do |project:, location:, featurestore:, entity_type:, feature:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "featurestore cannot contain /" if featurestore.to_s.include? "/"
+                  raise ::ArgumentError, "entity_type cannot contain /" if entity_type.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/featurestores/#{featurestore}/entityTypes/#{entity_type}/features/#{feature}"
+                end),
+                "feature:feature_group:location:project" => (proc do |project:, location:, feature_group:, feature:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "feature_group cannot contain /" if feature_group.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/featureGroups/#{feature_group}/features/#{feature}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
+            ##
+            # Create a fully-qualified FeatureGroup resource string.
+            #
             # The resource will be in the following format:
             #
-            # `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}`
+            # `projects/{project}/locations/{location}/featureGroups/{feature_group}`
             #
             # @param project [String]
             # @param location [String]
-            # @param featurestore [String]
-            # @param entity_type [String]
-            # @param feature [String]
+            # @param feature_group [String]
             #
             # @return [::String]
-            def feature_path project:, location:, featurestore:, entity_type:, feature:
+            def feature_group_path project:, location:, feature_group:
               raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
               raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
-              raise ::ArgumentError, "featurestore cannot contain /" if featurestore.to_s.include? "/"
-              raise ::ArgumentError, "entity_type cannot contain /" if entity_type.to_s.include? "/"
 
-              "projects/#{project}/locations/#{location}/featurestores/#{featurestore}/entityTypes/#{entity_type}/features/#{feature}"
+              "projects/#{project}/locations/#{location}/featureGroups/#{feature_group}"
             end
 
             ##