RubyGems - google-cloud-functions-v1 - Versions diffs - 0.13.1 → 0.14.0 - Mend

google-cloud-functions-v1 0.13.1 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

checksums.yaml +4 -4
data/lib/google/cloud/functions/v1/cloud_functions_service/client.rb +19 -12
data/lib/google/cloud/functions/v1/cloud_functions_service/rest/client.rb +19 -12
data/lib/google/cloud/functions/v1/functions_pb.rb +3 -1
data/lib/google/cloud/functions/v1/functions_services_pb.rb +7 -7
data/lib/google/cloud/functions/v1/version.rb +1 -1
data/proto_docs/google/cloud/functions/v1/functions.rb +91 -77
metadata +2 -2

checksums.yaml CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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