google-cloud-functions-v1 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2cf74213fbdd2baf3be4bd28c3f06e11e4de253a168aa82e66fdcac81ff69dc
-  data.tar.gz: 3337f91356501519dec70e0be7b39467b3127a88334a1d0122a3ee761f961c4a
+  metadata.gz: 4d6e2dd300e2a69aacd17e83e836edabd70ac59e121760509941cc6eb96bd91e
+  data.tar.gz: b0af785d3a9c0a03b2011a63cf6fe7690d1bd859a49a80ab2b67329b97380c32
 SHA512:
-  metadata.gz: 3aec811f3bef44a7410fe1c6ca1401d30af6a498b3f977ccb7841627634e1ffe10b47c706c9966daa39dfbe8248a309510c76e3d9cb630b311aac131966f06c1
-  data.tar.gz: 1fc0ce81ced55bcbc461fa0760dc0c716076766ce88133a6ca4dcf199f3aea7e6bc9a813d96347a0ffabbc96622c13cc89f67e92582c058b627f57de1311ad73
+  metadata.gz: dd5f9fdcb00aff9dd799ecd0891b5d412aa952b5319bc7092636c0d2fb46622f2cad93689d521243eaf23a516e9b2add9fd97869335e66378fb618c90171be91
+  data.tar.gz: d96488272340992dd1bc2d3471fb5bf788f89278817405f656a3666d28ef83c971a899d533d73514a2ba8c68f4ca0a38011655a09db228ba1cbde1c5c1527234

data/lib/google/cloud/functions/v1/cloud_functions_service/client.rb

@@ -221,6 +221,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Functions::V1::ListFunctionsRequest.new
+            #
+            #   # Call the list_functions method.
+            #   result = client.list_functions request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Functions::V1::CloudFunction.
+            #     p response
+            #   end
+            #
             def list_functions request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -238,9 +259,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -290,6 +313,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Functions::V1::GetFunctionRequest.new
+            #
+            #   # Call the get_function method.
+            #   result = client.get_function request
+            #
+            #   # The returned object is of type Google::Cloud::Functions::V1::CloudFunction.
+            #   p result
+            #
             def get_function request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -307,9 +345,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -363,6 +403,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Functions::V1::CreateFunctionRequest.new
+            #
+            #   # Call the create_function method.
+            #   result = client.create_function request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def create_function request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -380,9 +442,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "location" => request.location
-              }
+              header_params = {}
+              if request.location
+                header_params["location"] = request.location
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -434,6 +498,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Functions::V1::UpdateFunctionRequest.new
+            #
+            #   # Call the update_function method.
+            #   result = client.update_function request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def update_function request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -451,9 +537,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "function.name" => request.function.name
-              }
+              header_params = {}
+              if request.function&.name
+                header_params["function.name"] = request.function.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -505,6 +593,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Functions::V1::DeleteFunctionRequest.new
+            #
+            #   # Call the delete_function method.
+            #   result = client.delete_function request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def delete_function request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -522,9 +632,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -579,6 +691,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Functions::V1::CallFunctionRequest.new
+            #
+            #   # Call the call_function method.
+            #   result = client.call_function request
+            #
+            #   # The returned object is of type Google::Cloud::Functions::V1::CallFunctionResponse.
+            #   p result
+            #
             def call_function request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -596,9 +723,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -672,6 +801,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Functions::V1::GenerateUploadUrlRequest.new
+            #
+            #   # Call the generate_upload_url method.
+            #   result = client.generate_upload_url request
+            #
+            #   # The returned object is of type Google::Cloud::Functions::V1::GenerateUploadUrlResponse.
+            #   p result
+            #
             def generate_upload_url request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -689,9 +833,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -748,6 +894,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Functions::V1::GenerateDownloadUrlRequest.new
+            #
+            #   # Call the generate_download_url method.
+            #   result = client.generate_download_url request
+            #
+            #   # The returned object is of type Google::Cloud::Functions::V1::GenerateDownloadUrlResponse.
+            #   p result
+            #
             def generate_download_url request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -765,9 +926,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -823,6 +986,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Iam::V1::SetIamPolicyRequest.new
+            #
+            #   # Call the set_iam_policy method.
+            #   result = client.set_iam_policy request
+            #
+            #   # The returned object is of type Google::Iam::V1::Policy.
+            #   p result
+            #
             def set_iam_policy request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -840,9 +1018,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -897,6 +1077,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Iam::V1::GetIamPolicyRequest.new
+            #
+            #   # Call the get_iam_policy method.
+            #   result = client.get_iam_policy request
+            #
+            #   # The returned object is of type Google::Iam::V1::Policy.
+            #   p result
+            #
             def get_iam_policy request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -914,9 +1109,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -974,6 +1171,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/functions/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Functions::V1::CloudFunctionsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Iam::V1::TestIamPermissionsRequest.new
+            #
+            #   # Call the test_iam_permissions method.
+            #   result = client.test_iam_permissions request
+            #
+            #   # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
+            #   p result
+            #
             def test_iam_permissions request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -991,9 +1203,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "resource" => request.resource
-              }
+              header_params = {}
+              if request.resource
+                header_params["resource"] = request.resource
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

data/lib/google/cloud/functions/v1/cloud_functions_service/operations.rb

@@ -143,6 +143,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::ListOperationsRequest.new
+            #
+            #   # Call the list_operations method.
+            #   result = client.list_operations request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Longrunning::Operation.
+            #     p response
+            #   end
+            #
             def list_operations request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -160,9 +181,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -215,6 +238,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::GetOperationRequest.new
+            #
+            #   # Call the get_operation method.
+            #   result = client.get_operation request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def get_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -232,9 +277,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -287,6 +334,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::DeleteOperationRequest.new
+            #
+            #   # Call the delete_operation method.
+            #   result = client.delete_operation request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -304,9 +366,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -364,6 +428,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::CancelOperationRequest.new
+            #
+            #   # Call the cancel_operation method.
+            #   result = client.cancel_operation request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def cancel_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -381,9 +460,11 @@ module Google
                 gapic_version: ::Google::Cloud::Functions::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -444,6 +525,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::WaitOperationRequest.new
+            #
+            #   # Call the wait_operation method.
+            #   result = client.wait_operation request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def wait_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/functions/v1/cloud_functions_service/paths.rb

@@ -43,6 +43,27 @@ module Google
               "projects/#{project}/locations/#{location}/functions/#{function}"
             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 Location resource string.
             #
@@ -60,6 +81,25 @@ module Google
               "projects/#{project}/locations/#{location}"
             end
 
+            ##
+            # Create a fully-qualified Repository resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/repositories/{repository}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param repository [String]
+            #
+            # @return [::String]
+            def repository_path project:, location:, repository:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/repositories/#{repository}"
+            end
+
             extend self
           end
         end

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

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/functions/v1/functions.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -13,6 +11,8 @@ require 'google/longrunning/operations_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/functions/v1/functions.proto", :syntax => :proto3) do
     add_message "google.cloud.functions.v1.CloudFunction" do
@@ -28,12 +28,21 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :version_id, :int64, 14
       map :labels, :string, :string, 15
       map :environment_variables, :string, :string, 17
+      map :build_environment_variables, :string, :string, 28
       optional :network, :string, 18
       optional :max_instances, :int32, 20
+      optional :min_instances, :int32, 32
       optional :vpc_connector, :string, 22
       optional :vpc_connector_egress_settings, :enum, 23, "google.cloud.functions.v1.CloudFunction.VpcConnectorEgressSettings"
       optional :ingress_settings, :enum, 24, "google.cloud.functions.v1.CloudFunction.IngressSettings"
+      optional :kms_key_name, :string, 25
+      optional :build_worker_pool, :string, 26
       optional :build_id, :string, 27
+      optional :build_name, :string, 33
+      repeated :secret_environment_variables, :message, 29, "google.cloud.functions.v1.SecretEnvVar"
+      repeated :secret_volumes, :message, 30, "google.cloud.functions.v1.SecretVolume"
+      optional :source_token, :string, 31
+      optional :docker_repository, :string, 34
       oneof :source_code do
         optional :source_archive_url, :string, 3
         optional :source_repository, :message, 4, "google.cloud.functions.v1.SourceRepository"
@@ -81,6 +90,22 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.functions.v1.FailurePolicy.Retry" do
     end
+    add_message "google.cloud.functions.v1.SecretEnvVar" do
+      optional :key, :string, 1
+      optional :project_id, :string, 2
+      optional :secret, :string, 3
+      optional :version, :string, 4
+    end
+    add_message "google.cloud.functions.v1.SecretVolume" do
+      optional :mount_path, :string, 1
+      optional :project_id, :string, 2
+      optional :secret, :string, 3
+      repeated :versions, :message, 4, "google.cloud.functions.v1.SecretVolume.SecretVersion"
+    end
+    add_message "google.cloud.functions.v1.SecretVolume.SecretVersion" do
+      optional :version, :string, 1
+      optional :path, :string, 2
+    end
     add_message "google.cloud.functions.v1.CreateFunctionRequest" do
       optional :location, :string, 1
       optional :function, :message, 2, "google.cloud.functions.v1.CloudFunction"
@@ -151,6 +176,9 @@ module Google
         EventTrigger = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.EventTrigger").msgclass
         FailurePolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.FailurePolicy").msgclass
         FailurePolicy::Retry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.FailurePolicy.Retry").msgclass
+        SecretEnvVar = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.SecretEnvVar").msgclass
+        SecretVolume = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.SecretVolume").msgclass
+        SecretVolume::SecretVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.SecretVolume.SecretVersion").msgclass
         CreateFunctionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CreateFunctionRequest").msgclass
         UpdateFunctionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.UpdateFunctionRequest").msgclass
         GetFunctionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.GetFunctionRequest").msgclass

data/lib/google/cloud/functions/v1/operations_pb.rb

@@ -1,11 +1,11 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/functions/v1/operations.proto
 
-require 'google/protobuf'
-
 require 'google/protobuf/any_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/api/annotations_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/functions/v1/operations.proto", :syntax => :proto3) do
     add_message "google.cloud.functions.v1.OperationMetadataV1" do
@@ -15,6 +15,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :version_id, :int64, 4
       optional :update_time, :message, 5, "google.protobuf.Timestamp"
       optional :build_id, :string, 6
+      optional :source_token, :string, 7
+      optional :build_name, :string, 8
     end
     add_enum "google.cloud.functions.v1.OperationType" do
       value :OPERATION_UNSPECIFIED, 0

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Functions
       module V1
-        VERSION = "0.4.0"
+        VERSION = "0.5.0"
       end
     end
   end

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

@@ -23,6 +23,7 @@ module Google
       module V1
         # Describes a Cloud Function that contains user computation executed in
         # response to an event. It encapsulate function and triggers configurations.
+        # Next tag: 36
         # @!attribute [rw] name
         #   @return [::String]
         #     A user-defined name of the function. Function names must be unique
@@ -97,6 +98,9 @@ module Google
         # @!attribute [rw] environment_variables
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Environment variables that shall be available during function execution.
+        # @!attribute [rw] build_environment_variables
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Build environment variables that shall be available during build time.
         # @!attribute [rw] network
         #   @return [::String]
         #     The VPC Network that this cloud function can connect to. It can be
@@ -117,6 +121,20 @@ module Google
         #   @return [::Integer]
         #     The limit on the maximum number of function instances that may coexist at a
         #     given time.
+        #
+        #     In some cases, such as rapid traffic surges, Cloud Functions may, for a
+        #     short period of time, create more instances than the specified max
+        #     instances limit. If your function cannot tolerate this temporary behavior,
+        #     you may want to factor in a safety margin and set a lower max instances
+        #     value than your function can tolerate.
+        #
+        #     See the [Max
+        #     Instances](https://cloud.google.com/functions/docs/max-instances) Guide for
+        #     more details.
+        # @!attribute [rw] min_instances
+        #   @return [::Integer]
+        #     A lower bound for the number function instances that may coexist at a
+        #     given time.
         # @!attribute [rw] vpc_connector
         #   @return [::String]
         #     The VPC Network Connector that this cloud function can connect to. It can
@@ -137,10 +155,83 @@ module Google
         #   @return [::Google::Cloud::Functions::V1::CloudFunction::IngressSettings]
         #     The ingress settings for the function, controlling what traffic can reach
         #     it.
+        # @!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}`.
+        #
+        #     If specified, you must also provide an artifact registry repository using
+        #     the `docker_repository` field that was created with the same KMS crypto
+        #     key.
+        #
+        #     The following service accounts need to be granted Cloud KMS crypto key
+        #     encrypter/decrypter roles on the key.
+        #
+        #     1. Google Cloud Functions service account
+        #        (service-\\{project_number}@gcf-admin-robot.iam.gserviceaccount.com) -
+        #        Required to protect the function's image.
+        #     2. Google Storage service account
+        #        (service-\\{project_number}@gs-project-accounts.iam.gserviceaccount.com) -
+        #        Required to protect the function's source code.
+        #        If this service account does not exist, deploying a function without a
+        #        KMS key or retrieving the service agent name provisions it. For more
+        #        information, see
+        #        https://cloud.google.com/storage/docs/projects#service-agents and
+        #        https://cloud.google.com/storage/docs/getting-service-agent#gsutil.
+        #
+        #     Google Cloud Functions delegates access to service agents to protect
+        #     function resources in internal projects that are not accessible by the
+        #     end user.
+        # @!attribute [rw] build_worker_pool
+        #   @return [::String]
+        #     Name of the Cloud Build Custom Worker Pool that should be used to build the
+        #     function. The format of this field is
+        #     `projects/{project}/locations/{region}/workerPools/{workerPool}` where
+        #     `{project}` and `{region}` are the project id and region respectively where
+        #     the worker pool is defined and `{workerPool}` is the short name of the
+        #     worker pool.
+        #
+        #     If the project id is not the same as the function, then the Cloud
+        #     Functions Service Agent
+        #     (`service-<project_number>@gcf-admin-robot.iam.gserviceaccount.com`) must
+        #     be granted the role Cloud Build Custom Workers Builder
+        #     (`roles/cloudbuild.customworkers.builder`) in the project.
         # @!attribute [r] build_id
         #   @return [::String]
         #     Output only. The Cloud Build ID of the latest successful deployment of the
         #     function.
+        # @!attribute [r] build_name
+        #   @return [::String]
+        #     Output only. The Cloud Build Name of the function deployment.
+        #     `projects/<project-number>/locations/<region>/builds/<build-id>`.
+        # @!attribute [rw] secret_environment_variables
+        #   @return [::Array<::Google::Cloud::Functions::V1::SecretEnvVar>]
+        #     Secret environment variables configuration.
+        # @!attribute [rw] secret_volumes
+        #   @return [::Array<::Google::Cloud::Functions::V1::SecretVolume>]
+        #     Secret volumes configuration.
+        # @!attribute [rw] source_token
+        #   @return [::String]
+        #     Input only. An identifier for Firebase function sources. Disclaimer: This field is only
+        #     supported for Firebase function deployments.
+        # @!attribute [rw] docker_repository
+        #   @return [::String]
+        #     User managed repository created in Artifact Registry optionally with a
+        #     customer managed encryption key. If specified, deployments will use
+        #     Artifact Registry. If unspecified and the deployment is eligible to use
+        #     Artifact Registry, GCF will create and use a repository named
+        #     'gcf-artifacts' for every deployed region. This is the repository to which
+        #     the function docker image will be pushed after it is built by Cloud Build.
+        #
+        #     It must match the pattern
+        #     `projects/{project}/locations/{location}/repositories/{repository}`.
+        #
+        #     Cross-project repositories are not supported.
+        #     Cross-location repositories are not supported.
+        #     Repository format must be 'DOCKER'.
         class CloudFunction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -163,6 +254,15 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class BuildEnvironmentVariablesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Available egress settings.
           #
           # This controls what traffic is diverted through the VPC Access Connector
@@ -332,6 +432,82 @@ module Google
           end
         end
 
+        # Configuration for a secret environment variable. It has the information
+        # necessary to fetch the secret value from secret manager and expose it as an
+        # environment variable. Secret value is not a part of the configuration. Secret
+        # values are only fetched when a new clone starts.
+        # @!attribute [rw] key
+        #   @return [::String]
+        #     Name of the environment variable.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Project identifier (preferrably project number but can also be the project
+        #     ID) of the project that contains the secret. If not set, it will be
+        #     populated with the function's project assuming that the secret exists in
+        #     the same project as of the function.
+        # @!attribute [rw] secret
+        #   @return [::String]
+        #     Name of the secret in secret manager (not the full resource name).
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Version of the secret (version number or the string 'latest'). It is
+        #     recommended to use a numeric version for secret environment variables as
+        #     any updates to the secret value is not reflected until new clones start.
+        class SecretEnvVar
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Configuration for a secret volume. It has the information necessary to fetch
+        # the secret value from secret manager and make it available as files mounted
+        # at the requested paths within the application container. Secret value is not
+        # a part of the configuration. Every filesystem read operation performs a
+        # lookup in secret manager to retrieve the secret value.
+        # @!attribute [rw] mount_path
+        #   @return [::String]
+        #     The path within the container to mount the secret volume. For example,
+        #     setting the mount_path as `/etc/secrets` would mount the secret value files
+        #     under the `/etc/secrets` directory. This directory will also be completely
+        #     shadowed and unavailable to mount any other secrets.
+        #
+        #     Recommended mount paths: /etc/secrets
+        #     Restricted mount paths: /cloudsql, /dev/log, /pod, /proc, /var/log
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Project identifier (preferrably project number but can also be the project
+        #     ID) of the project that contains the secret. If not set, it will be
+        #     populated with the function's project assuming that the secret exists in
+        #     the same project as of the function.
+        # @!attribute [rw] secret
+        #   @return [::String]
+        #     Name of the secret in secret manager (not the full resource name).
+        # @!attribute [rw] versions
+        #   @return [::Array<::Google::Cloud::Functions::V1::SecretVolume::SecretVersion>]
+        #     List of secret versions to mount for this secret. If empty, the `latest`
+        #     version of the secret will be made available in a file named after the
+        #     secret under the mount point.
+        class SecretVolume
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Configuration for a single version.
+          # @!attribute [rw] version
+          #   @return [::String]
+          #     Version of the secret (version number or the string 'latest'). It is
+          #     preferrable to use `latest` version with secret volumes as secret value
+          #     changes are reflected immediately.
+          # @!attribute [rw] path
+          #   @return [::String]
+          #     Relative path of the file under the mount path where the secret value for
+          #     this version will be fetched and made available. For example, setting the
+          #     mount_path as '/etc/secrets' and path as `/secret_foo` would mount the
+          #     secret value file at `/etc/secrets/secret_foo`.
+          class SecretVersion
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # Request for the `CreateFunction` method.
         # @!attribute [rw] location
         #   @return [::String]

data/proto_docs/google/cloud/functions/v1/operations.rb

@@ -43,6 +43,15 @@ module Google
         #   @return [::String]
         #     The Cloud Build ID of the function created or updated by an API call.
         #     This field is only populated for Create and Update operations.
+        # @!attribute [rw] source_token
+        #   @return [::String]
+        #     An identifier for Firebase function sources. Disclaimer: This field is only
+        #     supported for Firebase function deployments.
+        # @!attribute [rw] build_name
+        #   @return [::String]
+        #     The Cloud Build Name of the function deployment.
+        #     This field is only populated for Create and Update operations.
+        #     `projects/<project-number>/locations/<region>/builds/<build-id>`.
         class OperationMetadataV1
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-functions-v1
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-22 00:00:00.000000000 Z
+date: 2021-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common