google-cloud-functions-v1 0.13.1 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ce227c34557943631cf07edc23e0997154bdb01c8aa1cc41e35c9d43c3d2cf7
-  data.tar.gz: 03a5bd6427ee2a7a77959fe64aa23ff3b93d2b9a56b4a601b5f6a2428de44049
+  metadata.gz: fae4c3d6dd66ac4324842cf847ac9e38f615bd6f8d4a39231a31f70d3b228d38
+  data.tar.gz: e47c7c53c711745246aaeae0539f7ed074a439913b258b30357243d386e21c6d
 SHA512:
-  metadata.gz: bce7fecce71ddceeed5282f8f8b1947ecc73bc43194098ee9d7c092a4180bfae81073292c0bb1d3f0fb6da7fc6a8a30535eaf9683d7fffe948cfb8de9a70942f
-  data.tar.gz: 7fd7e61df73771f1bb987c4d405d58a2eb2f7eeb88c2ecb46cee00771a192797073212c1420754fc008539c67a880199164f0b21dabe02e393fdafebe0c26eb9
+  metadata.gz: 8a8f268248b7edaa0819501973a0c3ce5bf57b442f0dcf441be23c0b5f570fb18100ff65c1f32f793ea1d02fd2f52fe2e9ac995be6781d797ea4661187e21dea
+  data.tar.gz: 67cbb29e0671e92d27b356490339e52d1f0144e179aa9bb4c7e349d2746bb30a44319a9273bfc638f2a9f06138976af073dbfac2ed040190d5881336512a8bd5

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

@@ -343,13 +343,20 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload get_function(name: nil)
+            # @overload get_function(name: nil, version_id: nil)
             #   Pass arguments to `get_function` 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 name [::String]
             #     Required. The name of the function which details should be obtained.
+            #   @param version_id [::Integer]
+            #     Optional. The optional version of the function whose details should be
+            #     obtained. The version of a 1st Gen function is an integer that starts from
+            #     1 and gets incremented on redeployments. Each deployment creates a config
+            #     version of the underlying function. GCF may keep historical configs for old
+            #     versions. This field can be specified to fetch the historical configs.
+            #     Leave it blank or set to 0 to get the latest version of the function.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Functions::V1::CloudFunction]
@@ -417,7 +424,7 @@ module Google
 
             ##
             # Creates a new function. If a function with the given name already exists in
-            # the specified project, the long running operation returns an
+            # the specified project, the long running operation will return
             # `ALREADY_EXISTS` error.
             #
             # @overload create_function(request, options = nil)
@@ -610,7 +617,7 @@ module Google
 
             ##
             # Deletes a function with the given name from the specified project. If the
-            # given function is used by some trigger, the trigger is updated to
+            # given function is used by some trigger, the trigger will be updated to
             # remove this function.
             #
             # @overload delete_function(request, options = nil)
@@ -811,12 +818,12 @@ module Google
             #   attached, the identity from the credentials would be used, but that
             #   identity does not have permissions to upload files to the URL.
             #
-            # When making an HTTP PUT request, these two headers must be specified:
+            # When making a HTTP PUT request, these two headers need to be specified:
             #
             # * `content-type: application/zip`
             # * `x-goog-content-length-range: 0,104857600`
             #
-            # And this header must NOT be specified:
+            # And this header SHOULD NOT be specified:
             #
             # * `Authorization: Bearer YOUR_TOKEN`
             #
@@ -840,11 +847,11 @@ module Google
             #     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 staging Cloud Storage
+            #     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 a staging Cloud Storage bucket in an internal regional
-            #     project. The source code is then copied to a versioned directory in the
-            #     sources bucket in the consumer project during the function deployment.
+            #     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}`.
@@ -923,9 +930,9 @@ module Google
 
             ##
             # Returns a signed URL for downloading deployed function source code.
-            # The URL is only valid for a limited period and must be used within
+            # The URL is only valid for a limited period and should be used within
             # minutes after generation.
-            # For more information about the signed URL usage, see:
+            # For more information about the signed URL usage see:
             # https://cloud.google.com/storage/docs/access-control/signed-urls
             #
             # @overload generate_download_url(request, options = nil)
@@ -1206,7 +1213,7 @@ module Google
             ##
             # Tests the specified permissions against the IAM access control policy
             # for a function.
-            # If the function does not exist, this returns an empty set of
+            # If the function does not exist, this will return an empty set of
             # permissions, not a NOT_FOUND error.
             #
             # @overload test_iam_permissions(request, options = nil)

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

@@ -329,13 +329,20 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload get_function(name: nil)
+              # @overload get_function(name: nil, version_id: nil)
               #   Pass arguments to `get_function` 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 name [::String]
               #     Required. The name of the function which details should be obtained.
+              #   @param version_id [::Integer]
+              #     Optional. The optional version of the function whose details should be
+              #     obtained. The version of a 1st Gen function is an integer that starts from
+              #     1 and gets incremented on redeployments. Each deployment creates a config
+              #     version of the underlying function. GCF may keep historical configs for old
+              #     versions. This field can be specified to fetch the historical configs.
+              #     Leave it blank or set to 0 to get the latest version of the function.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::Functions::V1::CloudFunction]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -396,7 +403,7 @@ module Google
 
               ##
               # Creates a new function. If a function with the given name already exists in
-              # the specified project, the long running operation returns an
+              # the specified project, the long running operation will return
               # `ALREADY_EXISTS` error.
               #
               # @overload create_function(request, options = nil)
@@ -575,7 +582,7 @@ module Google
 
               ##
               # Deletes a function with the given name from the specified project. If the
-              # given function is used by some trigger, the trigger is updated to
+              # given function is used by some trigger, the trigger will be updated to
               # remove this function.
               #
               # @overload delete_function(request, options = nil)
@@ -762,12 +769,12 @@ module Google
               #   attached, the identity from the credentials would be used, but that
               #   identity does not have permissions to upload files to the URL.
               #
-              # When making an HTTP PUT request, these two headers must be specified:
+              # When making a HTTP PUT request, these two headers need to be specified:
               #
               # * `content-type: application/zip`
               # * `x-goog-content-length-range: 0,104857600`
               #
-              # And this header must NOT be specified:
+              # And this header SHOULD NOT be specified:
               #
               # * `Authorization: Bearer YOUR_TOKEN`
               #
@@ -791,11 +798,11 @@ module Google
               #     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 staging Cloud Storage
+              #     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 a staging Cloud Storage bucket in an internal regional
-              #     project. The source code is then copied to a versioned directory in the
-              #     sources bucket in the consumer project during the function deployment.
+              #     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}`.
@@ -867,9 +874,9 @@ module Google
 
               ##
               # Returns a signed URL for downloading deployed function source code.
-              # The URL is only valid for a limited period and must be used within
+              # The URL is only valid for a limited period and should be used within
               # minutes after generation.
-              # For more information about the signed URL usage, see:
+              # For more information about the signed URL usage see:
               # https://cloud.google.com/storage/docs/access-control/signed-urls
               #
               # @overload generate_download_url(request, options = nil)
@@ -1129,7 +1136,7 @@ module Google
               ##
               # Tests the specified permissions against the IAM access control policy
               # for a function.
-              # If the function does not exist, this returns an empty set of
+              # If the function does not exist, this will return an empty set of
               # permissions, not a NOT_FOUND error.
               #
               # @overload test_iam_permissions(request, options = nil)

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

@@ -18,7 +18,7 @@ require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 
 
-descriptor_data = "\n)google/cloud/functions/v1/functions.proto\x12\x19google.cloud.functions.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a*google/cloud/functions/v1/operations.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xe7\x11\n\rCloudFunction\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x1c\n\x12source_archive_url\x18\x03 \x01(\tH\x00\x12H\n\x11source_repository\x18\x04 \x01(\x0b\x32+.google.cloud.functions.v1.SourceRepositoryH\x00\x12\x1b\n\x11source_upload_url\x18\x10 \x01(\tH\x00\x12@\n\rhttps_trigger\x18\x05 \x01(\x0b\x32\'.google.cloud.functions.v1.HttpsTriggerH\x01\x12@\n\revent_trigger\x18\x06 \x01(\x0b\x32\'.google.cloud.functions.v1.EventTriggerH\x01\x12\x43\n\x06status\x18\x07 \x01(\x0e\x32..google.cloud.functions.v1.CloudFunctionStatusB\x03\xe0\x41\x03\x12\x13\n\x0b\x65ntry_point\x18\x08 \x01(\t\x12\x0f\n\x07runtime\x18\x13 \x01(\t\x12*\n\x07timeout\x18\t \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x1b\n\x13\x61vailable_memory_mb\x18\n \x01(\x05\x12\x1d\n\x15service_account_email\x18\x0b \x01(\t\x12\x34\n\x0bupdate_time\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x17\n\nversion_id\x18\x0e \x01(\x03\x42\x03\xe0\x41\x03\x12\x44\n\x06labels\x18\x0f \x03(\x0b\x32\x34.google.cloud.functions.v1.CloudFunction.LabelsEntry\x12\x61\n\x15\x65nvironment_variables\x18\x11 \x03(\x0b\x32\x42.google.cloud.functions.v1.CloudFunction.EnvironmentVariablesEntry\x12l\n\x1b\x62uild_environment_variables\x18\x1c \x03(\x0b\x32G.google.cloud.functions.v1.CloudFunction.BuildEnvironmentVariablesEntry\x12\x0f\n\x07network\x18\x12 \x01(\t\x12\x15\n\rmax_instances\x18\x14 \x01(\x05\x12\x15\n\rmin_instances\x18  \x01(\x05\x12\x15\n\rvpc_connector\x18\x16 \x01(\t\x12j\n\x1dvpc_connector_egress_settings\x18\x17 \x01(\x0e\x32\x43.google.cloud.functions.v1.CloudFunction.VpcConnectorEgressSettings\x12R\n\x10ingress_settings\x18\x18 \x01(\x0e\x32\x38.google.cloud.functions.v1.CloudFunction.IngressSettings\x12<\n\x0ckms_key_name\x18\x19 \x01(\tB&\xfa\x41#\n!cloudkms.googleapis.com/CryptoKey\x12\x19\n\x11\x62uild_worker_pool\x18\x1a \x01(\t\x12\x15\n\x08\x62uild_id\x18\x1b \x01(\tB\x03\xe0\x41\x03\x12\x17\n\nbuild_name\x18! \x01(\tB\x03\xe0\x41\x03\x12M\n\x1csecret_environment_variables\x18\x1d \x03(\x0b\x32\'.google.cloud.functions.v1.SecretEnvVar\x12?\n\x0esecret_volumes\x18\x1e \x03(\x0b\x32\'.google.cloud.functions.v1.SecretVolume\x12\x19\n\x0csource_token\x18\x1f \x01(\tB\x03\xe0\x41\x04\x12J\n\x11\x64ocker_repository\x18\" \x01(\tB/\xfa\x41,\n*artifactregistry.googleapis.com/Repository\x12P\n\x0f\x64ocker_registry\x18# \x01(\x0e\x32\x37.google.cloud.functions.v1.CloudFunction.DockerRegistry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a;\n\x19\x45nvironmentVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a@\n\x1e\x42uildEnvironmentVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"u\n\x1aVpcConnectorEgressSettings\x12-\n)VPC_CONNECTOR_EGRESS_SETTINGS_UNSPECIFIED\x10\x00\x12\x17\n\x13PRIVATE_RANGES_ONLY\x10\x01\x12\x0f\n\x0b\x41LL_TRAFFIC\x10\x02\"x\n\x0fIngressSettings\x12 \n\x1cINGRESS_SETTINGS_UNSPECIFIED\x10\x00\x12\r\n\tALLOW_ALL\x10\x01\x12\x17\n\x13\x41LLOW_INTERNAL_ONLY\x10\x02\x12\x1b\n\x17\x41LLOW_INTERNAL_AND_GCLB\x10\x03\"`\n\x0e\x44ockerRegistry\x12\x1f\n\x1b\x44OCKER_REGISTRY_UNSPECIFIED\x10\x00\x12\x16\n\x12\x43ONTAINER_REGISTRY\x10\x01\x12\x15\n\x11\x41RTIFACT_REGISTRY\x10\x02:n\xea\x41k\n+cloudfunctions.googleapis.com/CloudFunction\x12<projects/{project}/locations/{location}/functions/{function}B\r\n\x0bsource_codeB\t\n\x07trigger\":\n\x10SourceRepository\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x19\n\x0c\x64\x65ployed_url\x18\x02 \x01(\tB\x03\xe0\x41\x03\"\xc8\x01\n\x0cHttpsTrigger\x12\x10\n\x03url\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12M\n\x0esecurity_level\x18\x02 \x01(\x0e\x32\x35.google.cloud.functions.v1.HttpsTrigger.SecurityLevel\"W\n\rSecurityLevel\x12\x1e\n\x1aSECURITY_LEVEL_UNSPECIFIED\x10\x00\x12\x11\n\rSECURE_ALWAYS\x10\x01\x12\x13\n\x0fSECURE_OPTIONAL\x10\x02\"\x87\x01\n\x0c\x45ventTrigger\x12\x12\n\nevent_type\x18\x01 \x01(\t\x12\x10\n\x08resource\x18\x02 \x01(\t\x12\x0f\n\x07service\x18\x03 \x01(\t\x12@\n\x0e\x66\x61ilure_policy\x18\x05 \x01(\x0b\x32(.google.cloud.functions.v1.FailurePolicy\"c\n\rFailurePolicy\x12?\n\x05retry\x18\x01 \x01(\x0b\x32..google.cloud.functions.v1.FailurePolicy.RetryH\x00\x1a\x07\n\x05RetryB\x08\n\x06\x61\x63tion\"P\n\x0cSecretEnvVar\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x12\n\nproject_id\x18\x02 \x01(\t\x12\x0e\n\x06secret\x18\x03 \x01(\t\x12\x0f\n\x07version\x18\x04 \x01(\t\"\xbf\x01\n\x0cSecretVolume\x12\x12\n\nmount_path\x18\x01 \x01(\t\x12\x12\n\nproject_id\x18\x02 \x01(\t\x12\x0e\n\x06secret\x18\x03 \x01(\t\x12G\n\x08versions\x18\x04 \x03(\x0b\x32\x35.google.cloud.functions.v1.SecretVolume.SecretVersion\x1a.\n\rSecretVersion\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\t\"\x95\x01\n\x15\x43reateFunctionRequest\x12;\n\x08location\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!locations.googleapis.com/Location\x12?\n\x08\x66unction\x18\x02 \x01(\x0b\x32(.google.cloud.functions.v1.CloudFunctionB\x03\xe0\x41\x02\"\x89\x01\n\x15UpdateFunctionRequest\x12?\n\x08\x66unction\x18\x01 \x01(\x0b\x32(.google.cloud.functions.v1.CloudFunctionB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"W\n\x12GetFunctionRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudfunctions.googleapis.com/CloudFunction\"u\n\x14ListFunctionsRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xfa\x41#\n!locations.googleapis.com/Location\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\"\x82\x01\n\x15ListFunctionsResponse\x12;\n\tfunctions\x18\x01 \x03(\x0b\x32(.google.cloud.functions.v1.CloudFunction\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x13\n\x0bunreachable\x18\x03 \x03(\t\"Z\n\x15\x44\x65leteFunctionRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudfunctions.googleapis.com/CloudFunction\"k\n\x13\x43\x61llFunctionRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudfunctions.googleapis.com/CloudFunction\x12\x11\n\x04\x64\x61ta\x18\x02 \x01(\tB\x03\xe0\x41\x02\"K\n\x14\x43\x61llFunctionResponse\x12\x14\n\x0c\x65xecution_id\x18\x01 \x01(\t\x12\x0e\n\x06result\x18\x02 \x01(\t\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"h\n\x18GenerateUploadUrlRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\x0ckms_key_name\x18\x02 \x01(\tB&\xfa\x41#\n!cloudkms.googleapis.com/CryptoKey\"/\n\x19GenerateUploadUrlResponse\x12\x12\n\nupload_url\x18\x01 \x01(\t\">\n\x1aGenerateDownloadUrlRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nversion_id\x18\x02 \x01(\x04\"3\n\x1bGenerateDownloadUrlResponse\x12\x14\n\x0c\x64ownload_url\x18\x01 \x01(\t*\x92\x01\n\x13\x43loudFunctionStatus\x12%\n!CLOUD_FUNCTION_STATUS_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0b\n\x07OFFLINE\x10\x02\x12\x16\n\x12\x44\x45PLOY_IN_PROGRESS\x10\x03\x12\x16\n\x12\x44\x45LETE_IN_PROGRESS\x10\x04\x12\x0b\n\x07UNKNOWN\x10\x05\x32\x97\x11\n\x15\x43loudFunctionsService\x12\xa9\x01\n\rListFunctions\x12/.google.cloud.functions.v1.ListFunctionsRequest\x1a\x30.google.cloud.functions.v1.ListFunctionsResponse\"5\x82\xd3\xe4\x93\x02/\x12-/v1/{parent=projects/*/locations/*}/functions\x12\xa4\x01\n\x0bGetFunction\x12-.google.cloud.functions.v1.GetFunctionRequest\x1a(.google.cloud.functions.v1.CloudFunction\"<\x82\xd3\xe4\x93\x02/\x12-/v1/{name=projects/*/locations/*/functions/*}\xda\x41\x04name\x12\xdf\x01\n\x0e\x43reateFunction\x12\x30.google.cloud.functions.v1.CreateFunctionRequest\x1a\x1d.google.longrunning.Operation\"|\x82\xd3\xe4\x93\x02;\"//v1/{location=projects/*/locations/*}/functions:\x08\x66unction\xda\x41\x11location,function\xca\x41$\n\rCloudFunction\x12\x13OperationMetadataV1\x12\xdd\x01\n\x0eUpdateFunction\x12\x30.google.cloud.functions.v1.UpdateFunctionRequest\x1a\x1d.google.longrunning.Operation\"z\x82\xd3\xe4\x93\x02\x42\x32\x36/v1/{function.name=projects/*/locations/*/functions/*}:\x08\x66unction\xda\x41\x08\x66unction\xca\x41$\n\rCloudFunction\x12\x13OperationMetadataV1\x12\xce\x01\n\x0e\x44\x65leteFunction\x12\x30.google.cloud.functions.v1.DeleteFunctionRequest\x1a\x1d.google.longrunning.Operation\"k\x82\xd3\xe4\x93\x02/*-/v1/{name=projects/*/locations/*/functions/*}\xda\x41\x04name\xca\x41,\n\x15google.protobuf.Empty\x12\x13OperationMetadataV1\x12\xba\x01\n\x0c\x43\x61llFunction\x12..google.cloud.functions.v1.CallFunctionRequest\x1a/.google.cloud.functions.v1.CallFunctionResponse\"I\x82\xd3\xe4\x93\x02\x37\"2/v1/{name=projects/*/locations/*/functions/*}:call:\x01*\xda\x41\tname,data\x12\xca\x01\n\x11GenerateUploadUrl\x12\x33.google.cloud.functions.v1.GenerateUploadUrlRequest\x1a\x34.google.cloud.functions.v1.GenerateUploadUrlResponse\"J\x82\xd3\xe4\x93\x02\x44\"?/v1/{parent=projects/*/locations/*}/functions:generateUploadUrl:\x01*\x12\xd2\x01\n\x13GenerateDownloadUrl\x12\x35.google.cloud.functions.v1.GenerateDownloadUrlRequest\x1a\x36.google.cloud.functions.v1.GenerateDownloadUrlResponse\"L\x82\xd3\xe4\x93\x02\x46\"A/v1/{name=projects/*/locations/*/functions/*}:generateDownloadUrl:\x01*\x12\x94\x01\n\x0cSetIamPolicy\x12\".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy\"I\x82\xd3\xe4\x93\x02\x43\">/v1/{resource=projects/*/locations/*/functions/*}:setIamPolicy:\x01*\x12\x91\x01\n\x0cGetIamPolicy\x12\".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy\"F\x82\xd3\xe4\x93\x02@\x12>/v1/{resource=projects/*/locations/*/functions/*}:getIamPolicy\x12\xba\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse\"O\x82\xd3\xe4\x93\x02I\"D/v1/{resource=projects/*/locations/*/functions/*}:testIamPermissions:\x01*\x1aQ\xca\x41\x1d\x63loudfunctions.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xe1\x02\n\x1d\x63om.google.cloud.functions.v1B\x0e\x46unctionsProtoP\x01Z;cloud.google.com/go/functions/apiv1/functionspb;functionspb\xa2\x02\x03GCF\xea\x41o\n*artifactregistry.googleapis.com/Repository\x12\x41projects/{project}/locations/{location}/repositories/{repository}\xea\x41x\n!cloudkms.googleapis.com/CryptoKey\x12Sprojects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}b\x06proto3"
+descriptor_data = "\n)google/cloud/functions/v1/functions.proto\x12\x19google.cloud.functions.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a*google/cloud/functions/v1/operations.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x98\x14\n\rCloudFunction\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x1c\n\x12source_archive_url\x18\x03 \x01(\tH\x00\x12H\n\x11source_repository\x18\x04 \x01(\x0b\x32+.google.cloud.functions.v1.SourceRepositoryH\x00\x12\x1b\n\x11source_upload_url\x18\x10 \x01(\tH\x00\x12@\n\rhttps_trigger\x18\x05 \x01(\x0b\x32\'.google.cloud.functions.v1.HttpsTriggerH\x01\x12@\n\revent_trigger\x18\x06 \x01(\x0b\x32\'.google.cloud.functions.v1.EventTriggerH\x01\x12\x43\n\x06status\x18\x07 \x01(\x0e\x32..google.cloud.functions.v1.CloudFunctionStatusB\x03\xe0\x41\x03\x12\x13\n\x0b\x65ntry_point\x18\x08 \x01(\t\x12\x0f\n\x07runtime\x18\x13 \x01(\t\x12*\n\x07timeout\x18\t \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x1b\n\x13\x61vailable_memory_mb\x18\n \x01(\x05\x12\x1d\n\x15service_account_email\x18\x0b \x01(\t\x12\x34\n\x0bupdate_time\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x17\n\nversion_id\x18\x0e \x01(\x03\x42\x03\xe0\x41\x03\x12\x44\n\x06labels\x18\x0f \x03(\x0b\x32\x34.google.cloud.functions.v1.CloudFunction.LabelsEntry\x12\x61\n\x15\x65nvironment_variables\x18\x11 \x03(\x0b\x32\x42.google.cloud.functions.v1.CloudFunction.EnvironmentVariablesEntry\x12l\n\x1b\x62uild_environment_variables\x18\x1c \x03(\x0b\x32G.google.cloud.functions.v1.CloudFunction.BuildEnvironmentVariablesEntry\x12\x13\n\x07network\x18\x12 \x01(\tB\x02\x18\x01\x12\x15\n\rmax_instances\x18\x14 \x01(\x05\x12\x15\n\rmin_instances\x18  \x01(\x05\x12\x15\n\rvpc_connector\x18\x16 \x01(\t\x12j\n\x1dvpc_connector_egress_settings\x18\x17 \x01(\x0e\x32\x43.google.cloud.functions.v1.CloudFunction.VpcConnectorEgressSettings\x12R\n\x10ingress_settings\x18\x18 \x01(\x0e\x32\x38.google.cloud.functions.v1.CloudFunction.IngressSettings\x12<\n\x0ckms_key_name\x18\x19 \x01(\tB&\xfa\x41#\n!cloudkms.googleapis.com/CryptoKey\x12\x19\n\x11\x62uild_worker_pool\x18\x1a \x01(\t\x12\x15\n\x08\x62uild_id\x18\x1b \x01(\tB\x03\xe0\x41\x03\x12\x17\n\nbuild_name\x18! \x01(\tB\x03\xe0\x41\x03\x12M\n\x1csecret_environment_variables\x18\x1d \x03(\x0b\x32\'.google.cloud.functions.v1.SecretEnvVar\x12?\n\x0esecret_volumes\x18\x1e \x03(\x0b\x32\'.google.cloud.functions.v1.SecretVolume\x12\x19\n\x0csource_token\x18\x1f \x01(\tB\x03\xe0\x41\x04\x12J\n\x11\x64ocker_repository\x18\" \x01(\tB/\xfa\x41,\n*artifactregistry.googleapis.com/Repository\x12P\n\x0f\x64ocker_registry\x18# \x01(\x0e\x32\x37.google.cloud.functions.v1.CloudFunction.DockerRegistry\x12\x61\n\x17\x61utomatic_update_policy\x18( \x01(\x0b\x32>.google.cloud.functions.v1.CloudFunction.AutomaticUpdatePolicyH\x02\x12`\n\x17on_deploy_update_policy\x18) \x01(\x0b\x32=.google.cloud.functions.v1.CloudFunction.OnDeployUpdatePolicyH\x02\x1a\x17\n\x15\x41utomaticUpdatePolicy\x1a\x34\n\x14OnDeployUpdatePolicy\x12\x1c\n\x0fruntime_version\x18\x01 \x01(\tB\x03\xe0\x41\x03\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a;\n\x19\x45nvironmentVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a@\n\x1e\x42uildEnvironmentVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"u\n\x1aVpcConnectorEgressSettings\x12-\n)VPC_CONNECTOR_EGRESS_SETTINGS_UNSPECIFIED\x10\x00\x12\x17\n\x13PRIVATE_RANGES_ONLY\x10\x01\x12\x0f\n\x0b\x41LL_TRAFFIC\x10\x02\"x\n\x0fIngressSettings\x12 \n\x1cINGRESS_SETTINGS_UNSPECIFIED\x10\x00\x12\r\n\tALLOW_ALL\x10\x01\x12\x17\n\x13\x41LLOW_INTERNAL_ONLY\x10\x02\x12\x1b\n\x17\x41LLOW_INTERNAL_AND_GCLB\x10\x03\"`\n\x0e\x44ockerRegistry\x12\x1f\n\x1b\x44OCKER_REGISTRY_UNSPECIFIED\x10\x00\x12\x16\n\x12\x43ONTAINER_REGISTRY\x10\x01\x12\x15\n\x11\x41RTIFACT_REGISTRY\x10\x02:n\xea\x41k\n+cloudfunctions.googleapis.com/CloudFunction\x12<projects/{project}/locations/{location}/functions/{function}B\r\n\x0bsource_codeB\t\n\x07triggerB\x17\n\x15runtime_update_policy\":\n\x10SourceRepository\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x19\n\x0c\x64\x65ployed_url\x18\x02 \x01(\tB\x03\xe0\x41\x03\"\xc8\x01\n\x0cHttpsTrigger\x12\x10\n\x03url\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12M\n\x0esecurity_level\x18\x02 \x01(\x0e\x32\x35.google.cloud.functions.v1.HttpsTrigger.SecurityLevel\"W\n\rSecurityLevel\x12\x1e\n\x1aSECURITY_LEVEL_UNSPECIFIED\x10\x00\x12\x11\n\rSECURE_ALWAYS\x10\x01\x12\x13\n\x0fSECURE_OPTIONAL\x10\x02\"\x87\x01\n\x0c\x45ventTrigger\x12\x12\n\nevent_type\x18\x01 \x01(\t\x12\x10\n\x08resource\x18\x02 \x01(\t\x12\x0f\n\x07service\x18\x03 \x01(\t\x12@\n\x0e\x66\x61ilure_policy\x18\x05 \x01(\x0b\x32(.google.cloud.functions.v1.FailurePolicy\"c\n\rFailurePolicy\x12?\n\x05retry\x18\x01 \x01(\x0b\x32..google.cloud.functions.v1.FailurePolicy.RetryH\x00\x1a\x07\n\x05RetryB\x08\n\x06\x61\x63tion\"P\n\x0cSecretEnvVar\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x12\n\nproject_id\x18\x02 \x01(\t\x12\x0e\n\x06secret\x18\x03 \x01(\t\x12\x0f\n\x07version\x18\x04 \x01(\t\"\xbf\x01\n\x0cSecretVolume\x12\x12\n\nmount_path\x18\x01 \x01(\t\x12\x12\n\nproject_id\x18\x02 \x01(\t\x12\x0e\n\x06secret\x18\x03 \x01(\t\x12G\n\x08versions\x18\x04 \x03(\x0b\x32\x35.google.cloud.functions.v1.SecretVolume.SecretVersion\x1a.\n\rSecretVersion\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\t\"\x95\x01\n\x15\x43reateFunctionRequest\x12;\n\x08location\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\n!locations.googleapis.com/Location\x12?\n\x08\x66unction\x18\x02 \x01(\x0b\x32(.google.cloud.functions.v1.CloudFunctionB\x03\xe0\x41\x02\"\x89\x01\n\x15UpdateFunctionRequest\x12?\n\x08\x66unction\x18\x01 \x01(\x0b\x32(.google.cloud.functions.v1.CloudFunctionB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"p\n\x12GetFunctionRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudfunctions.googleapis.com/CloudFunction\x12\x17\n\nversion_id\x18\x02 \x01(\x03\x42\x03\xe0\x41\x01\"u\n\x14ListFunctionsRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xfa\x41#\n!locations.googleapis.com/Location\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\"\x82\x01\n\x15ListFunctionsResponse\x12;\n\tfunctions\x18\x01 \x03(\x0b\x32(.google.cloud.functions.v1.CloudFunction\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x13\n\x0bunreachable\x18\x03 \x03(\t\"Z\n\x15\x44\x65leteFunctionRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudfunctions.googleapis.com/CloudFunction\"k\n\x13\x43\x61llFunctionRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudfunctions.googleapis.com/CloudFunction\x12\x11\n\x04\x64\x61ta\x18\x02 \x01(\tB\x03\xe0\x41\x02\"K\n\x14\x43\x61llFunctionResponse\x12\x14\n\x0c\x65xecution_id\x18\x01 \x01(\t\x12\x0e\n\x06result\x18\x02 \x01(\t\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"h\n\x18GenerateUploadUrlRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\x0ckms_key_name\x18\x02 \x01(\tB&\xfa\x41#\n!cloudkms.googleapis.com/CryptoKey\"/\n\x19GenerateUploadUrlResponse\x12\x12\n\nupload_url\x18\x01 \x01(\t\">\n\x1aGenerateDownloadUrlRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nversion_id\x18\x02 \x01(\x04\"3\n\x1bGenerateDownloadUrlResponse\x12\x14\n\x0c\x64ownload_url\x18\x01 \x01(\t*\x92\x01\n\x13\x43loudFunctionStatus\x12%\n!CLOUD_FUNCTION_STATUS_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0b\n\x07OFFLINE\x10\x02\x12\x16\n\x12\x44\x45PLOY_IN_PROGRESS\x10\x03\x12\x16\n\x12\x44\x45LETE_IN_PROGRESS\x10\x04\x12\x0b\n\x07UNKNOWN\x10\x05\x32\x97\x11\n\x15\x43loudFunctionsService\x12\xa9\x01\n\rListFunctions\x12/.google.cloud.functions.v1.ListFunctionsRequest\x1a\x30.google.cloud.functions.v1.ListFunctionsResponse\"5\x82\xd3\xe4\x93\x02/\x12-/v1/{parent=projects/*/locations/*}/functions\x12\xa4\x01\n\x0bGetFunction\x12-.google.cloud.functions.v1.GetFunctionRequest\x1a(.google.cloud.functions.v1.CloudFunction\"<\x82\xd3\xe4\x93\x02/\x12-/v1/{name=projects/*/locations/*/functions/*}\xda\x41\x04name\x12\xdf\x01\n\x0e\x43reateFunction\x12\x30.google.cloud.functions.v1.CreateFunctionRequest\x1a\x1d.google.longrunning.Operation\"|\x82\xd3\xe4\x93\x02;\"//v1/{location=projects/*/locations/*}/functions:\x08\x66unction\xda\x41\x11location,function\xca\x41$\n\rCloudFunction\x12\x13OperationMetadataV1\x12\xdd\x01\n\x0eUpdateFunction\x12\x30.google.cloud.functions.v1.UpdateFunctionRequest\x1a\x1d.google.longrunning.Operation\"z\x82\xd3\xe4\x93\x02\x42\x32\x36/v1/{function.name=projects/*/locations/*/functions/*}:\x08\x66unction\xda\x41\x08\x66unction\xca\x41$\n\rCloudFunction\x12\x13OperationMetadataV1\x12\xce\x01\n\x0e\x44\x65leteFunction\x12\x30.google.cloud.functions.v1.DeleteFunctionRequest\x1a\x1d.google.longrunning.Operation\"k\x82\xd3\xe4\x93\x02/*-/v1/{name=projects/*/locations/*/functions/*}\xda\x41\x04name\xca\x41,\n\x15google.protobuf.Empty\x12\x13OperationMetadataV1\x12\xba\x01\n\x0c\x43\x61llFunction\x12..google.cloud.functions.v1.CallFunctionRequest\x1a/.google.cloud.functions.v1.CallFunctionResponse\"I\x82\xd3\xe4\x93\x02\x37\"2/v1/{name=projects/*/locations/*/functions/*}:call:\x01*\xda\x41\tname,data\x12\xca\x01\n\x11GenerateUploadUrl\x12\x33.google.cloud.functions.v1.GenerateUploadUrlRequest\x1a\x34.google.cloud.functions.v1.GenerateUploadUrlResponse\"J\x82\xd3\xe4\x93\x02\x44\"?/v1/{parent=projects/*/locations/*}/functions:generateUploadUrl:\x01*\x12\xd2\x01\n\x13GenerateDownloadUrl\x12\x35.google.cloud.functions.v1.GenerateDownloadUrlRequest\x1a\x36.google.cloud.functions.v1.GenerateDownloadUrlResponse\"L\x82\xd3\xe4\x93\x02\x46\"A/v1/{name=projects/*/locations/*/functions/*}:generateDownloadUrl:\x01*\x12\x94\x01\n\x0cSetIamPolicy\x12\".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy\"I\x82\xd3\xe4\x93\x02\x43\">/v1/{resource=projects/*/locations/*/functions/*}:setIamPolicy:\x01*\x12\x91\x01\n\x0cGetIamPolicy\x12\".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy\"F\x82\xd3\xe4\x93\x02@\x12>/v1/{resource=projects/*/locations/*/functions/*}:getIamPolicy\x12\xba\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse\"O\x82\xd3\xe4\x93\x02I\"D/v1/{resource=projects/*/locations/*/functions/*}:testIamPermissions:\x01*\x1aQ\xca\x41\x1d\x63loudfunctions.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xe1\x02\n\x1d\x63om.google.cloud.functions.v1B\x0e\x46unctionsProtoP\x01Z;cloud.google.com/go/functions/apiv1/functionspb;functionspb\xa2\x02\x03GCF\xea\x41o\n*artifactregistry.googleapis.com/Repository\x12\x41projects/{project}/locations/{location}/repositories/{repository}\xea\x41x\n!cloudkms.googleapis.com/CryptoKey\x12Sprojects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}b\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 
@@ -52,6 +52,8 @@ module Google
     module Functions
       module V1
         CloudFunction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction").msgclass
+        CloudFunction::AutomaticUpdatePolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction.AutomaticUpdatePolicy").msgclass
+        CloudFunction::OnDeployUpdatePolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction.OnDeployUpdatePolicy").msgclass
         CloudFunction::VpcConnectorEgressSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction.VpcConnectorEgressSettings").enummodule
         CloudFunction::IngressSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction.IngressSettings").enummodule
         CloudFunction::DockerRegistry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction.DockerRegistry").enummodule

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

@@ -38,13 +38,13 @@ module Google
             # Returns a function with the given name from the requested project.
             rpc :GetFunction, ::Google::Cloud::Functions::V1::GetFunctionRequest, ::Google::Cloud::Functions::V1::CloudFunction
             # Creates a new function. If a function with the given name already exists in
-            # the specified project, the long running operation returns an
+            # the specified project, the long running operation will return
             # `ALREADY_EXISTS` error.
             rpc :CreateFunction, ::Google::Cloud::Functions::V1::CreateFunctionRequest, ::Google::Longrunning::Operation
             # Updates existing function.
             rpc :UpdateFunction, ::Google::Cloud::Functions::V1::UpdateFunctionRequest, ::Google::Longrunning::Operation
             # Deletes a function with the given name from the specified project. If the
-            # given function is used by some trigger, the trigger is updated to
+            # given function is used by some trigger, the trigger will be updated to
             # remove this function.
             rpc :DeleteFunction, ::Google::Cloud::Functions::V1::DeleteFunctionRequest, ::Google::Longrunning::Operation
             # Synchronously invokes a deployed Cloud Function. To be used for testing
@@ -69,19 +69,19 @@ module Google
             #   attached, the identity from the credentials would be used, but that
             #   identity does not have permissions to upload files to the URL.
             #
-            # When making an HTTP PUT request, these two headers must be specified:
+            # When making a HTTP PUT request, these two headers need to be specified:
             #
             # * `content-type: application/zip`
             # * `x-goog-content-length-range: 0,104857600`
             #
-            # And this header must NOT be specified:
+            # And this header SHOULD NOT be specified:
             #
             # * `Authorization: Bearer YOUR_TOKEN`
             rpc :GenerateUploadUrl, ::Google::Cloud::Functions::V1::GenerateUploadUrlRequest, ::Google::Cloud::Functions::V1::GenerateUploadUrlResponse
             # Returns a signed URL for downloading deployed function source code.
-            # The URL is only valid for a limited period and must be used within
+            # The URL is only valid for a limited period and should be used within
             # minutes after generation.
-            # For more information about the signed URL usage, see:
+            # For more information about the signed URL usage see:
             # https://cloud.google.com/storage/docs/access-control/signed-urls
             rpc :GenerateDownloadUrl, ::Google::Cloud::Functions::V1::GenerateDownloadUrlRequest, ::Google::Cloud::Functions::V1::GenerateDownloadUrlResponse
             # Sets the IAM access control policy on the specified function.
@@ -93,7 +93,7 @@ module Google
             rpc :GetIamPolicy, ::Google::Iam::V1::GetIamPolicyRequest, ::Google::Iam::V1::Policy
             # Tests the specified permissions against the IAM access control policy
             # for a function.
-            # If the function does not exist, this returns an empty set of
+            # If the function does not exist, this will return an empty set of
             # permissions, not a NOT_FOUND error.
             rpc :TestIamPermissions, ::Google::Iam::V1::TestIamPermissionsRequest, ::Google::Iam::V1::TestIamPermissionsResponse
           end

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Functions
       module V1
-        VERSION = "0.13.1"
+        VERSION = "0.14.0"
       end
     end
   end

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

@@ -22,7 +22,7 @@ module Google
     module Functions
       module V1
         # Describes a Cloud Function that contains user computation executed in
-        # response to an event. It encapsulates function and triggers configurations.
+        # response to an event. It encapsulate function and triggers configurations.
         # @!attribute [rw] name
         #   @return [::String]
         #     A user-defined name of the function. Function names must be unique
@@ -41,7 +41,7 @@ module Google
         #     The source repository where a function is hosted.
         # @!attribute [rw] source_upload_url
         #   @return [::String]
-        #     The Google Cloud Storage-signed URL used for source uploading, generated
+        #     The Google Cloud Storage signed URL used for source uploading, generated
         #     by calling [google.cloud.functions.v1.GenerateUploadUrl].
         #
         #     The signature is validated on write methods (Create, Update)
@@ -58,12 +58,9 @@ module Google
         #     Output only. Status of the function deployment.
         # @!attribute [rw] entry_point
         #   @return [::String]
-        #     The name of the function (as defined in source code) that is executed.
-        #     Defaults to the resource name suffix, if not specified. For
-        #     backward compatibility, if function with given name is not found, the
-        #     system tries to use the function named "function".
-        #     For Node.js, this is the name of a function exported by the module
-        #     as specified in `source_location`.
+        #     The name of the function (as defined in source code) that will be
+        #     executed. Defaults to the resource name suffix (ID of the function), if not
+        #     specified.
         # @!attribute [rw] runtime
         #   @return [::String]
         #     The runtime in which to run the function. Required when deploying a new
@@ -101,30 +98,18 @@ module Google
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Build environment variables that shall be available during build time.
         # @!attribute [rw] network
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::String]
-        #     The Serverless VPC Access connector that this cloud function can connect
-        #     to. It can be either the fully qualified URI, or the short name of the
-        #     connector resource. If the connector name is used, the connector must
-        #     belong to the same project as the function. Otherwise, it must belong to a
-        #     project within the same organization. The format of this field is either
-        #     `projects/{project}/global/networks/{network}` or `{network}`, where
-        #     `{project}` is a project id where the network is defined, and `{network}`
-        #     is the short name of the network.
-        #
-        #     This field is mutually exclusive with `vpc_connector` and will be replaced
-        #     by it.
-        #
-        #     See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for
-        #     more information on connecting Cloud projects.
+        #     Deprecated: use vpc_connector
         # @!attribute [rw] max_instances
         #   @return [::Integer]
-        #     The limit on the maximum number of function instances that can coexist at a
+        #     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 can for a
-        #     short period of time create more instances than the specified max
+        #     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 might want to factor in a safety margin and set a lower max instances
+        #     you may want to factor in a safety margin and set a lower max instances
         #     value than your function can tolerate.
         #
         #     See the [Max
@@ -132,12 +117,12 @@ module Google
         #     more details.
         # @!attribute [rw] min_instances
         #   @return [::Integer]
-        #     A lower bound for the number function instances that can coexist at a
+        #     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
-        #     be either the fully qualified URI, or the short name of the network
+        #     be either the fully-qualified URI, or the short name of the network
         #     connector resource. The format of this field is
         #     `projects/*/locations/*/connectors/*`
         #
@@ -224,7 +209,7 @@ module Google
         #     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 is pushed after it is built by Cloud Build.
+        #     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}`.
@@ -236,14 +221,36 @@ module Google
         #   @return [::Google::Cloud::Functions::V1::CloudFunction::DockerRegistry]
         #     Docker Registry to use for this deployment.
         #
-        #     If `docker_repository` field is specified, this field is automatically
-        #     set as `ARTIFACT_REGISTRY`.
-        #     If unspecified, it currently defaults to `CONTAINER_REGISTRY`.
-        #     This field may be overridden by the backend for eligible deployments.
+        #     If unspecified, it defaults to `ARTIFACT_REGISTRY`.
+        #     If `docker_repository` field is specified, this field should either be left
+        #     unspecified or set to `ARTIFACT_REGISTRY`.
+        # @!attribute [rw] automatic_update_policy
+        #   @return [::Google::Cloud::Functions::V1::CloudFunction::AutomaticUpdatePolicy]
+        #     See the comment next to this message for more details.
+        # @!attribute [rw] on_deploy_update_policy
+        #   @return [::Google::Cloud::Functions::V1::CloudFunction::OnDeployUpdatePolicy]
+        #     See the comment next to this message for more details.
         class CloudFunction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Security patches are applied automatically to the runtime without requiring
+          # the function to be redeployed.
+          class AutomaticUpdatePolicy
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Security patches are only applied when a function is redeployed.
+          # @!attribute [r] runtime_version
+          #   @return [::String]
+          #     Output only. contains the runtime version which was used during latest
+          #     function deployment.
+          class OnDeployUpdatePolicy
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value
@@ -273,18 +280,17 @@ module Google
 
           # Available egress settings.
           #
-          # This controls what traffic is diverted through the Serverless VPC Access
-          # connector resource. By default, PRIVATE_RANGES_ONLY is used.
+          # This controls what traffic is diverted through the VPC Access Connector
+          # resource. By default PRIVATE_RANGES_ONLY will be used.
           module VpcConnectorEgressSettings
             # Unspecified.
             VPC_CONNECTOR_EGRESS_SETTINGS_UNSPECIFIED = 0
 
-            # Use the Serverless VPC Access connector only for private IP space from
-            # RFC1918.
+            # Use the VPC Access Connector only for private IP space from RFC1918.
             PRIVATE_RANGES_ONLY = 1
 
-            # Force the use of Serverless VPC Access connector for all egress traffic
-            # from the function.
+            # Force the use of VPC Access Connector for all egress traffic from the
+            # function.
             ALL_TRAFFIC = 2
           end
 
@@ -292,7 +298,7 @@ module Google
           #
           # This controls what traffic can reach the function.
           #
-          # If unspecified, ALLOW_ALL is used.
+          # If unspecified, ALLOW_ALL will be used.
           module IngressSettings
             # Unspecified.
             INGRESS_SETTINGS_UNSPECIFIED = 0
@@ -312,15 +318,15 @@ module Google
             # Unspecified.
             DOCKER_REGISTRY_UNSPECIFIED = 0
 
-            # Docker images are stored in multi-regional Container Registry
+            # Docker images will be stored in multi-regional Container Registry
             # repositories named `gcf`.
             CONTAINER_REGISTRY = 1
 
-            # Docker images are stored in regional Artifact Registry repositories.
-            # By default, Cloud Functions creates and uses 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 by using the
-            # `docker_repository` field.
+            # 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
@@ -341,7 +347,7 @@ module Google
         #     To refer to a specific fixed alias (tag):
         #     `https://source.developers.google.com/projects/*/repos/*/fixed-aliases/*/paths/*`
         #
-        #     You can omit `paths/*` if you want to use the main directory.
+        #     You may omit `paths/*` if you want to use the main directory.
         # @!attribute [r] deployed_url
         #   @return [::String]
         #     Output only. The URL pointing to the hosted repository where the function
@@ -363,11 +369,11 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Available security-level settings.
+          # Available security level settings.
           #
           # This controls the methods to enforce security (HTTPS) on a URL.
           #
-          # If unspecified, SECURE_OPTIONAL is used.
+          # If unspecified, SECURE_OPTIONAL will be used.
           module SecurityLevel
             # Unspecified.
             SECURITY_LEVEL_UNSPECIFIED = 0
@@ -384,7 +390,7 @@ module Google
           end
         end
 
-        # Describes EventTrigger, used to request that events be sent from another
+        # Describes EventTrigger, used to request events be sent from another
         # service.
         # @!attribute [rw] event_type
         #   @return [::String]
@@ -401,7 +407,7 @@ module Google
         #        example, the Google Cloud Storage API includes the type `object`.
         #     3. action: The action that generates the event. For example, action for
         #        a Google Cloud Storage Object is 'change'.
-        #     These parts are lowercase.
+        #     These parts are lower case.
         # @!attribute [rw] resource
         #   @return [::String]
         #     Required. The resource(s) from which to observe events, for example,
@@ -419,7 +425,7 @@ module Google
         #        that matches Google Cloud Pub/Sub topics.
         #
         #     Additionally, some services may support short names when creating an
-        #     `EventTrigger`. These are always returned in the normalized "long"
+        #     `EventTrigger`. These will always be returned in the normalized "long"
         #     format.
         #
         #     See each *service's* documentation for supported formats.
@@ -439,17 +445,17 @@ module Google
         end
 
         # Describes the policy in case of function's execution failure.
-        # If empty, then defaults to ignoring failures (i.e., not retrying them).
+        # If empty, then defaults to ignoring failures (i.e. not retrying them).
         # @!attribute [rw] retry
         #   @return [::Google::Cloud::Functions::V1::FailurePolicy::Retry]
-        #     If specified, the function is retried in case of a failure.
+        #     If specified, then the function will be retried in case of a failure.
         class FailurePolicy
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # Describes the retry policy in case of function's execution failure.
-          # A function execution is retried on any failure.
-          # A failed execution is retried up to 7 days with an exponential backoff
+          # A function execution will be retried on any failure.
+          # A failed execution will be retried up to 7 days with an exponential backoff
           # (capped at 10 seconds).
           # Retried execution is charged as any other execution.
           class Retry
@@ -459,7 +465,7 @@ module Google
         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
+        # necessary to fetch the secret value from secret manager and expose it as an
         # environment variable.
         # @!attribute [rw] key
         #   @return [::String]
@@ -467,12 +473,12 @@ module Google
         # @!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 is
-        #     populated with the function's project, assuming that the secret exists in
-        #     the same project as the function.
+        #     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).
+        #     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
@@ -484,15 +490,15 @@ module Google
         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
+        # 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 file system read operation performs a
-        # lookup in Secret Manager to retrieve the secret value.
+        # 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` mounts the secret value files
-        #     under the `/etc/secrets` directory. This directory is also completely
+        #     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
@@ -500,16 +506,16 @@ module Google
         # @!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 is
-        #     populated with the function's project, assuming that the secret exists in
-        #     the same project as the function.
+        #     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).
+        #     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 is made available in a file named after the
+        #     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
@@ -524,8 +530,8 @@ module Google
           # @!attribute [rw] path
           #   @return [::String]
           #     Relative path of the file under the mount path where the secret value for
-          #     this version is fetched and made available. For example, setting the
-          #     mount_path as '/etc/secrets' and path as `/secret_foo` mounts the
+          #     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
@@ -562,6 +568,14 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The name of the function which details should be obtained.
+        # @!attribute [rw] version_id
+        #   @return [::Integer]
+        #     Optional. The optional version of the function whose details should be
+        #     obtained. The version of a 1st Gen function is an integer that starts from
+        #     1 and gets incremented on redeployments. Each deployment creates a config
+        #     version of the underlying function. GCF may keep historical configs for old
+        #     versions. This field can be specified to fetch the historical configs.
+        #     Leave it blank or set to 0 to get the latest version of the function.
         class GetFunctionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -655,11 +669,11 @@ module Google
         # @!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 staging Cloud Storage
+        #     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 a staging Cloud Storage bucket in an internal regional
-        #     project. The source code is then copied to a versioned directory in the
-        #     sources bucket in the consumer project during the function deployment.
+        #     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}`.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-functions-v1
 version: !ruby/object:Gem::Version
-  version: 0.13.1
+  version: 0.14.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-12 00:00:00.000000000 Z
+date: 2024-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common