google-cloud-functions-v2 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a84cfe684d197806a2385398444d215cf441c9d344cf5dd9510650ed2bf5a813
-  data.tar.gz: 6930a19679bbcccb9128b8ba163dfa767de79067e47c0a26b1c305c987efad12
+  metadata.gz: 60a81c1d07f91c14470579fea2f02c13b9cdc460546439a3fe7e8bf431bc5795
+  data.tar.gz: 6e832526b2b135a129c99ce511f39317faf39d3cfffb1f3fc82c239fcc844027
 SHA512:
-  metadata.gz: 53511fa8acbed5395bc927287cef772e2b8506b85d299750df53fe20793c08acd19630ae3a2a5bbf888c5f0608306149e0b971b634105a7564ee9f2786e5228e
-  data.tar.gz: d70201eef45a956c178199549265b5210b4db6f3778581593ea1418129b7aa65fd777f4a3df0a6a4a44940011dc6b5187e9521eaa06c814fac40b7081801848f
+  metadata.gz: 0e6df6babde60d6e014dc9b40982cddd2f076be628e4474f3093727fd151940b3fe6a0facc29e450a3c52532bd82fafc15598e3d1d1f643647f8d34a3cc02c10
+  data.tar.gz: f5275ce31e58401c21b165779200dfe86f0e37d2357f076550a1ba18c75cf73a973caec3cebef92e91b41e8c05a2fbfbc66773c040033454f8f7c4df96bb59eb

data/README.md

@@ -47,7 +47,7 @@ for general usage information.
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
 The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
 

data/lib/google/cloud/functions/v2/function_service/client.rb

@@ -294,14 +294,17 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The project and location from which the function should be listed,
-            #     specified in the format `projects/*/locations/*`
-            #     If you want to list functions in all locations, use "-" in place of a
-            #     location. When listing functions in all locations, if one or more
-            #     location(s) are unreachable, the response will contain functions from all
-            #     reachable locations along with the names of any unreachable locations.
+            #     Required. The project and location from which the function should be
+            #     listed, specified in the format `projects/*/locations/*` If you want to
+            #     list functions in all locations, use "-" in place of a location. When
+            #     listing functions in all locations, if one or more location(s) are
+            #     unreachable, the response will contain functions from all reachable
+            #     locations along with the names of any unreachable locations.
             #   @param page_size [::Integer]
-            #     Maximum number of functions to return per call.
+            #     Maximum number of functions to return per call. The largest allowed
+            #     page_size is 1,000, if the page_size is omitted or specified as greater
+            #     than 1,000 then it will be replaced as 1,000. The size of the list
+            #     response can be less than specified when used with filters.
             #   @param page_token [::String]
             #     The value returned by the last
             #     `ListFunctionsResponse`; indicates that
@@ -405,8 +408,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The project and location in which the function should be created, specified
-            #     in the format `projects/*/locations/*`
+            #     Required. The project and location in which the function should be created,
+            #     specified in the format `projects/*/locations/*`
             #   @param function [::Google::Cloud::Functions::V2::Function, ::Hash]
             #     Required. Function to be created.
             #   @param function_id [::String]
@@ -715,14 +718,30 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload generate_upload_url(parent: nil)
+            # @overload generate_upload_url(parent: nil, kms_key_name: nil)
             #   Pass arguments to `generate_upload_url` 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 parent [::String]
-            #     Required. The project and location in which the Google Cloud Storage signed URL
-            #     should be generated, specified in the format `projects/*/locations/*`.
+            #     Required. The project and location in which the Google Cloud Storage signed
+            #     URL should be generated, specified in the format `projects/*/locations/*`.
+            #   @param kms_key_name [::String]
+            #     Resource name of a KMS crypto key (managed by the user) used to
+            #     encrypt/decrypt function source code objects in intermediate Cloud Storage
+            #     buckets. When you generate an upload url and upload your source code, it
+            #     gets copied to an intermediate Cloud Storage bucket. The source code is
+            #     then copied to a versioned directory in the sources bucket in the consumer
+            #     project during the function deployment.
+            #
+            #     It must match the pattern
+            #     `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
+            #
+            #     The Google Cloud Functions service account
+            #     (service-\\{project_number}@gcf-admin-robot.iam.gserviceaccount.com) must be
+            #     granted the role 'Cloud KMS CryptoKey Encrypter/Decrypter
+            #     (roles/cloudkms.cryptoKeyEncrypterDecrypter)' on the
+            #     Key/KeyRing/Project/Organization (least access preferred).
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Functions::V2::GenerateUploadUrlResponse]
@@ -811,8 +830,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of function for which source code Google Cloud Storage signed
-            #     URL should be generated.
+            #     Required. The name of function for which source code Google Cloud Storage
+            #     signed URL should be generated.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Functions::V2::GenerateDownloadUrlResponse]
@@ -897,8 +916,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The project and location from which the runtimes should be listed,
-            #     specified in the format `projects/*/locations/*`
+            #     Required. The project and location from which the runtimes should be
+            #     listed, specified in the format `projects/*/locations/*`
             #   @param filter [::String]
             #     The filter for Runtimes that match the filter expression,
             #     following the syntax outlined in https://google.aip.dev/160.
@@ -1005,9 +1024,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/functions/v2/function_service/operations.rb

@@ -620,9 +620,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/functions/v2/function_service/paths.rb

@@ -81,6 +81,27 @@ module Google
               "projects/#{project}/locations/#{location}/connectors/#{connector}"
             end
 
+            ##
+            # Create a fully-qualified CryptoKey resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param key_ring [String]
+            # @param crypto_key [String]
+            #
+            # @return [::String]
+            def crypto_key_path project:, location:, key_ring:, crypto_key:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "key_ring cannot contain /" if key_ring.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/keyRings/#{key_ring}/cryptoKeys/#{crypto_key}"
+            end
+
             ##
             # Create a fully-qualified Function resource string.
             #

data/lib/google/cloud/functions/v2/function_service/rest/client.rb

@@ -264,14 +264,17 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The project and location from which the function should be listed,
-              #     specified in the format `projects/*/locations/*`
-              #     If you want to list functions in all locations, use "-" in place of a
-              #     location. When listing functions in all locations, if one or more
-              #     location(s) are unreachable, the response will contain functions from all
-              #     reachable locations along with the names of any unreachable locations.
+              #     Required. The project and location from which the function should be
+              #     listed, specified in the format `projects/*/locations/*` If you want to
+              #     list functions in all locations, use "-" in place of a location. When
+              #     listing functions in all locations, if one or more location(s) are
+              #     unreachable, the response will contain functions from all reachable
+              #     locations along with the names of any unreachable locations.
               #   @param page_size [::Integer]
-              #     Maximum number of functions to return per call.
+              #     Maximum number of functions to return per call. The largest allowed
+              #     page_size is 1,000, if the page_size is omitted or specified as greater
+              #     than 1,000 then it will be replaced as 1,000. The size of the list
+              #     response can be less than specified when used with filters.
               #   @param page_token [::String]
               #     The value returned by the last
               #     `ListFunctionsResponse`; indicates that
@@ -347,8 +350,8 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The project and location in which the function should be created, specified
-              #     in the format `projects/*/locations/*`
+              #     Required. The project and location in which the function should be created,
+              #     specified in the format `projects/*/locations/*`
               #   @param function [::Google::Cloud::Functions::V2::Function, ::Hash]
               #     Required. Function to be created.
               #   @param function_id [::String]
@@ -567,14 +570,30 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload generate_upload_url(parent: nil)
+              # @overload generate_upload_url(parent: nil, kms_key_name: nil)
               #   Pass arguments to `generate_upload_url` 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 parent [::String]
-              #     Required. The project and location in which the Google Cloud Storage signed URL
-              #     should be generated, specified in the format `projects/*/locations/*`.
+              #     Required. The project and location in which the Google Cloud Storage signed
+              #     URL should be generated, specified in the format `projects/*/locations/*`.
+              #   @param kms_key_name [::String]
+              #     Resource name of a KMS crypto key (managed by the user) used to
+              #     encrypt/decrypt function source code objects in intermediate Cloud Storage
+              #     buckets. When you generate an upload url and upload your source code, it
+              #     gets copied to an intermediate Cloud Storage bucket. The source code is
+              #     then copied to a versioned directory in the sources bucket in the consumer
+              #     project during the function deployment.
+              #
+              #     It must match the pattern
+              #     `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
+              #
+              #     The Google Cloud Functions service account
+              #     (service-\\{project_number}@gcf-admin-robot.iam.gserviceaccount.com) must be
+              #     granted the role 'Cloud KMS CryptoKey Encrypter/Decrypter
+              #     (roles/cloudkms.cryptoKeyEncrypterDecrypter)' on the
+              #     Key/KeyRing/Project/Organization (least access preferred).
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::Functions::V2::GenerateUploadUrlResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -640,8 +659,8 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param name [::String]
-              #     Required. The name of function for which source code Google Cloud Storage signed
-              #     URL should be generated.
+              #     Required. The name of function for which source code Google Cloud Storage
+              #     signed URL should be generated.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::Functions::V2::GenerateDownloadUrlResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -703,8 +722,8 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The project and location from which the runtimes should be listed,
-              #     specified in the format `projects/*/locations/*`
+              #     Required. The project and location from which the runtimes should be
+              #     listed, specified in the format `projects/*/locations/*`
               #   @param filter [::String]
               #     The filter for Runtimes that match the filter expression,
               #     following the syntax outlined in https://google.aip.dev/160.
@@ -788,9 +807,9 @@ module Google
               #    *  (`String`) The path to a service account key file in JSON format
               #    *  (`Hash`) A service account key as a Hash
               #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-              #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+              #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-              #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+              #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope

data/lib/google/cloud/functions/v2/function_service/rest/operations.rb

@@ -411,9 +411,9 @@ module Google
               #    *  (`String`) The path to a service account key file in JSON format
               #    *  (`Hash`) A service account key as a Hash
               #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-              #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+              #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-              #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+              #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
               #   @return [::Object]
               # @!attribute [rw] scope

data/lib/google/cloud/functions/v2/functions_pb.rb

@@ -9,6 +9,7 @@ require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/any_pb'
+require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 
@@ -25,6 +26,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :update_time, :message, 7, "google.protobuf.Timestamp"
       map :labels, :string, :string, 8
       repeated :state_messages, :message, 9, "google.cloud.functions.v2.StateMessage"
+      optional :kms_key_name, :string, 25
+      optional :url, :string, 14
     end
     add_enum "google.cloud.functions.v2.Function.State" do
       value :STATE_UNSPECIFIED, 0
@@ -79,12 +82,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :source_provenance, :message, 8, "google.cloud.functions.v2.SourceProvenance"
       optional :worker_pool, :string, 5
       map :environment_variables, :string, :string, 6
+      optional :docker_registry, :enum, 10, "google.cloud.functions.v2.BuildConfig.DockerRegistry"
       optional :docker_repository, :string, 7
     end
+    add_enum "google.cloud.functions.v2.BuildConfig.DockerRegistry" do
+      value :DOCKER_REGISTRY_UNSPECIFIED, 0
+      value :CONTAINER_REGISTRY, 1
+      value :ARTIFACT_REGISTRY, 2
+    end
     add_message "google.cloud.functions.v2.ServiceConfig" do
       optional :service, :string, 1
       optional :timeout_seconds, :int32, 2
       optional :available_memory, :string, 13
+      optional :available_cpu, :string, 22
       map :environment_variables, :string, :string, 4
       optional :max_instance_count, :int32, 5
       optional :min_instance_count, :int32, 12
@@ -97,6 +107,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :secret_environment_variables, :message, 17, "google.cloud.functions.v2.SecretEnvVar"
       repeated :secret_volumes, :message, 19, "google.cloud.functions.v2.SecretVolume"
       optional :revision, :string, 18
+      optional :max_instance_request_concurrency, :int32, 20
+      optional :security_level, :enum, 21, "google.cloud.functions.v2.ServiceConfig.SecurityLevel"
     end
     add_enum "google.cloud.functions.v2.ServiceConfig.VpcConnectorEgressSettings" do
       value :VPC_CONNECTOR_EGRESS_SETTINGS_UNSPECIFIED, 0
@@ -109,6 +121,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :ALLOW_INTERNAL_ONLY, 2
       value :ALLOW_INTERNAL_AND_GCLB, 3
     end
+    add_enum "google.cloud.functions.v2.ServiceConfig.SecurityLevel" do
+      value :SECURITY_LEVEL_UNSPECIFIED, 0
+      value :SECURE_ALWAYS, 1
+      value :SECURE_OPTIONAL, 2
+    end
     add_message "google.cloud.functions.v2.SecretEnvVar" do
       optional :key, :string, 1
       optional :project_id, :string, 2
@@ -174,6 +191,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.functions.v2.GenerateUploadUrlRequest" do
       optional :parent, :string, 1
+      optional :kms_key_name, :string, 2
     end
     add_message "google.cloud.functions.v2.GenerateUploadUrlResponse" do
       optional :upload_url, :string, 1
@@ -263,9 +281,11 @@ module Google
         Source = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.Source").msgclass
         SourceProvenance = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.SourceProvenance").msgclass
         BuildConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.BuildConfig").msgclass
+        BuildConfig::DockerRegistry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.BuildConfig.DockerRegistry").enummodule
         ServiceConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.ServiceConfig").msgclass
         ServiceConfig::VpcConnectorEgressSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.ServiceConfig.VpcConnectorEgressSettings").enummodule
         ServiceConfig::IngressSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.ServiceConfig.IngressSettings").enummodule
+        ServiceConfig::SecurityLevel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.ServiceConfig.SecurityLevel").enummodule
         SecretEnvVar = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.SecretEnvVar").msgclass
         SecretVolume = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.SecretVolume").msgclass
         SecretVolume::SecretVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v2.SecretVolume.SecretVersion").msgclass

data/lib/google/cloud/functions/v2/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Functions
       module V2
-        VERSION = "0.2.0"
+        VERSION = "0.3.0"
       end
     end
   end

data/proto_docs/google/api/client.rb

@@ -35,7 +35,9 @@ module Google
     # Details about how and where to publish client libraries.
     # @!attribute [rw] version
     #   @return [::String]
-    #     Version of the API to apply these settings to.
+    #     Version of the API to apply these settings to. This is the full protobuf
+    #     package for the API, ending in the version element.
+    #     Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
     # @!attribute [rw] launch_stage
     #   @return [::Google::Api::LaunchStage]
     #     Launch stage of this version of the API.
@@ -111,6 +113,10 @@ module Google
     #     Client library settings.  If the same version string appears multiple
     #     times in this list, then the last one wins.  Settings from earlier
     #     settings with the same version string are discarded.
+    # @!attribute [rw] proto_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to proto reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -240,8 +246,8 @@ module Google
     #     Example of a YAML configuration::
     #
     #      publishing:
-    #        method_behavior:
-    #          - selector: CreateAdDomain
+    #        method_settings:
+    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
     #              initial_poll_delay:
     #                seconds: 60 # 1 minute

data/proto_docs/google/cloud/functions/v2/functions.rb

@@ -29,7 +29,7 @@ module Google
         #     globally and match pattern `projects/*/locations/*/functions/*`
         # @!attribute [rw] environment
         #   @return [::Google::Cloud::Functions::V2::Environment]
-        #     Describe whether the function is gen1 or gen2.
+        #     Describe whether the function is 1st Gen or 2nd Gen.
         # @!attribute [rw] description
         #   @return [::String]
         #     User-provided description of a function.
@@ -57,6 +57,16 @@ module Google
         # @!attribute [r] state_messages
         #   @return [::Array<::Google::Cloud::Functions::V2::StateMessage>]
         #     Output only. State Messages for this Cloud Function.
+        # @!attribute [rw] kms_key_name
+        #   @return [::String]
+        #     Resource name of a KMS crypto key (managed by the user) used to
+        #     encrypt/decrypt function resources.
+        #
+        #     It must match the pattern
+        #     `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
+        # @!attribute [r] url
+        #   @return [::String]
+        #     Output only. The deployed url for the function.
         class Function
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -215,8 +225,8 @@ module Google
         # given source.
         # @!attribute [r] build
         #   @return [::String]
-        #     Output only. The Cloud Build name of the latest successful deployment of the
-        #     function.
+        #     Output only. The Cloud Build name of the latest successful deployment of
+        #     the function.
         # @!attribute [rw] runtime
         #   @return [::String]
         #     The runtime in which to run the function. Required when deploying a new
@@ -255,9 +265,19 @@ module Google
         # @!attribute [rw] environment_variables
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     User-provided build-time environment variables for the function
+        # @!attribute [rw] docker_registry
+        #   @return [::Google::Cloud::Functions::V2::BuildConfig::DockerRegistry]
+        #     Optional. Docker Registry to use for this deployment. This configuration is
+        #     only applicable to 1st Gen functions, 2nd Gen functions can only use
+        #     Artifact Registry.
+        #
+        #     If `docker_repository` field is specified, this field will be automatically
+        #     set as `ARTIFACT_REGISTRY`.
+        #     If unspecified, it currently defaults to `CONTAINER_REGISTRY`.
+        #     This field may be overridden by the backend for eligible deployments.
         # @!attribute [rw] docker_repository
         #   @return [::String]
-        #     Optional. User managed repository created in Artifact Registry optionally with a
+        #     User managed repository created in Artifact Registry optionally with a
         #     customer managed encryption key. This is the repository to which the
         #     function docker image will be pushed after it is built by Cloud Build.
         #     If unspecified, GCF will create and use a repository named 'gcf-artifacts'
@@ -281,10 +301,28 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Docker Registry to use for storing function Docker images.
+          module DockerRegistry
+            # Unspecified.
+            DOCKER_REGISTRY_UNSPECIFIED = 0
+
+            # Docker images will be stored in multi-regional Container Registry
+            # repositories named `gcf`.
+            CONTAINER_REGISTRY = 1
+
+            # Docker images will be stored in regional Artifact Registry repositories.
+            # By default, GCF will create and use repositories named `gcf-artifacts`
+            # in every region in which a function is deployed. But the repository to
+            # use can also be specified by the user using the `docker_repository`
+            # field.
+            ARTIFACT_REGISTRY = 2
+          end
         end
 
         # Describes the Service being deployed.
         # Currently Supported : Cloud Run (fully managed).
+        # Next tag: 23
         # @!attribute [r] service
         #   @return [::String]
         #     Output only. Name of the service associated with a Function.
@@ -303,6 +341,13 @@ module Google
         #     See
         #     https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
         #     a full description.
+        # @!attribute [rw] available_cpu
+        #   @return [::String]
+        #     The number of CPUs used in a single container instance.
+        #     Default value is calculated from available memory.
+        #     Supports the same values as Cloud Run, see
+        #     https://cloud.google.com/run/docs/reference/rest/v1/Container#resourcerequirements
+        #     Example: "1" indicates 1 vCPU
         # @!attribute [rw] environment_variables
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Environment variables that shall be available during function execution.
@@ -366,6 +411,16 @@ module Google
         # @!attribute [r] revision
         #   @return [::String]
         #     Output only. The name of service revision.
+        # @!attribute [rw] max_instance_request_concurrency
+        #   @return [::Integer]
+        #     Sets the maximum number of concurrent requests that each instance can
+        #     receive. Defaults to 1.
+        # @!attribute [rw] security_level
+        #   @return [::Google::Cloud::Functions::V2::ServiceConfig::SecurityLevel]
+        #     Security level configure whether the function only accepts https.
+        #     This configuration is only applicable to 1st Gen functions with Http
+        #     trigger. By default https is optional for 1st Gen functions; 2nd Gen
+        #     functions are https ONLY.
         class ServiceConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -413,6 +468,27 @@ module Google
             # Allow HTTP traffic from private VPC sources and through GCLB.
             ALLOW_INTERNAL_AND_GCLB = 3
           end
+
+          # Available security level settings.
+          #
+          # This enforces security protocol on function URL.
+          #
+          # Security level is only ocnfigurable for 1st Gen functions, If unspecified,
+          # SECURE_OPTIONAL will be used. 2nd Gen functions are SECURE_ALWAYS ONLY.
+          module SecurityLevel
+            # Unspecified.
+            SECURITY_LEVEL_UNSPECIFIED = 0
+
+            # Requests for a URL that match this handler that do not use HTTPS are
+            # automatically redirected to the HTTPS URL with the same path. Query
+            # parameters are reserved for the redirect.
+            SECURE_ALWAYS = 1
+
+            # Both HTTP and HTTPS requests with URLs that match the handler succeed
+            # without redirects. The application can examine the request to determine
+            # which protocol was used and respond accordingly.
+            SECURE_OPTIONAL = 2
+          end
         end
 
         # Configuration for a secret environment variable. It has the information
@@ -489,8 +565,8 @@ module Google
         # service.
         # @!attribute [r] trigger
         #   @return [::String]
-        #     Output only. The resource name of the Eventarc trigger. The format of this field is
-        #     `projects/{project}/locations/{region}/triggers/{trigger}`.
+        #     Output only. The resource name of the Eventarc trigger. The format of this
+        #     field is `projects/{project}/locations/{region}/triggers/{trigger}`.
         # @!attribute [rw] trigger_region
         #   @return [::String]
         #     The region that the trigger will be in. The trigger will only receive
@@ -516,14 +592,15 @@ module Google
         #     will not be deleted at function deletion.
         # @!attribute [rw] service_account_email
         #   @return [::String]
-        #     Optional. The email of the trigger's service account. The service account must have
-        #     permission to invoke Cloud Run services, the permission is
+        #     Optional. The email of the trigger's service account. The service account
+        #     must have permission to invoke Cloud Run services, the permission is
         #     `run.routes.invoke`.
         #     If empty, defaults to the Compute Engine default service account:
         #     `{project_number}-compute@developer.gserviceaccount.com`.
         # @!attribute [rw] retry_policy
         #   @return [::Google::Cloud::Functions::V2::EventTrigger::RetryPolicy]
-        #     Optional. If unset, then defaults to ignoring failures (i.e. not retrying them).
+        #     Optional. If unset, then defaults to ignoring failures (i.e. not retrying
+        #     them).
         # @!attribute [rw] channel
         #   @return [::String]
         #     Optional. The name of the channel associated with the trigger in
@@ -578,15 +655,18 @@ module Google
         # Request for the `ListFunctions` method.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The project and location from which the function should be listed,
-        #     specified in the format `projects/*/locations/*`
-        #     If you want to list functions in all locations, use "-" in place of a
-        #     location. When listing functions in all locations, if one or more
-        #     location(s) are unreachable, the response will contain functions from all
-        #     reachable locations along with the names of any unreachable locations.
+        #     Required. The project and location from which the function should be
+        #     listed, specified in the format `projects/*/locations/*` If you want to
+        #     list functions in all locations, use "-" in place of a location. When
+        #     listing functions in all locations, if one or more location(s) are
+        #     unreachable, the response will contain functions from all reachable
+        #     locations along with the names of any unreachable locations.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Maximum number of functions to return per call.
+        #     Maximum number of functions to return per call. The largest allowed
+        #     page_size is 1,000, if the page_size is omitted or specified as greater
+        #     than 1,000 then it will be replaced as 1,000. The size of the list
+        #     response can be less than specified when used with filters.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The value returned by the last
@@ -627,8 +707,8 @@ module Google
         # Request for the `CreateFunction` method.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The project and location in which the function should be created, specified
-        #     in the format `projects/*/locations/*`
+        #     Required. The project and location in which the function should be created,
+        #     specified in the format `projects/*/locations/*`
         # @!attribute [rw] function
         #   @return [::Google::Cloud::Functions::V2::Function]
         #     Required. Function to be created.
@@ -670,8 +750,25 @@ module Google
         # Request of `GenerateSourceUploadUrl` method.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The project and location in which the Google Cloud Storage signed URL
-        #     should be generated, specified in the format `projects/*/locations/*`.
+        #     Required. The project and location in which the Google Cloud Storage signed
+        #     URL should be generated, specified in the format `projects/*/locations/*`.
+        # @!attribute [rw] kms_key_name
+        #   @return [::String]
+        #     Resource name of a KMS crypto key (managed by the user) used to
+        #     encrypt/decrypt function source code objects in intermediate Cloud Storage
+        #     buckets. When you generate an upload url and upload your source code, it
+        #     gets copied to an intermediate Cloud Storage bucket. The source code is
+        #     then copied to a versioned directory in the sources bucket in the consumer
+        #     project during the function deployment.
+        #
+        #     It must match the pattern
+        #     `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
+        #
+        #     The Google Cloud Functions service account
+        #     (service-\\{project_number}@gcf-admin-robot.iam.gserviceaccount.com) must be
+        #     granted the role 'Cloud KMS CryptoKey Encrypter/Decrypter
+        #     (roles/cloudkms.cryptoKeyEncrypterDecrypter)' on the
+        #     Key/KeyRing/Project/Organization (least access preferred).
         class GenerateUploadUrlRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -701,8 +798,8 @@ module Google
         # Request of `GenerateDownloadUrl` method.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The name of function for which source code Google Cloud Storage signed
-        #     URL should be generated.
+        #     Required. The name of function for which source code Google Cloud Storage
+        #     signed URL should be generated.
         class GenerateDownloadUrlRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -721,8 +818,8 @@ module Google
         # Request for the `ListRuntimes` method.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The project and location from which the runtimes should be listed,
-        #     specified in the format `projects/*/locations/*`
+        #     Required. The project and location from which the runtimes should be
+        #     listed, specified in the format `projects/*/locations/*`
         # @!attribute [rw] filter
         #   @return [::String]
         #     The filter for Runtimes that match the filter expression,
@@ -807,8 +904,9 @@ module Google
         #   @return [::Boolean]
         #     Identifies whether the user has requested cancellation
         #     of the operation. Operations that have successfully been cancelled
-        #     have [Operation.error][] value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-        #     corresponding to `Code.CANCELLED`.
+        #     have [Operation.error][] value with a
+        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
+        #     `Code.CANCELLED`.
         # @!attribute [rw] api_version
         #   @return [::String]
         #     API version used to start the operation.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-functions-v2
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-08 00:00:00.000000000 Z
+date: 2023-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common