google-cloud-run-v2 0.15.0 → 0.16.1

data/lib/google/cloud/run/v2/tasks/client.rb

@@ -31,6 +31,9 @@ module Google
           # Cloud Run Task Control Plane API.
           #
           class Client
+            # @private
+            API_VERSION = ""
+
             # @private
             DEFAULT_ENDPOINT_TEMPLATE = "run.$UNIVERSE_DOMAIN$"
 
@@ -232,10 +235,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.get_task.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Run::V2::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
@@ -331,10 +335,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.list_tasks.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::Run::V2::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}

data/lib/google/cloud/run/v2/tasks/rest/client.rb

@@ -33,6 +33,9 @@ module Google
             # Cloud Run Task Control Plane API.
             #
             class Client
+              # @private
+              API_VERSION = ""
+
               # @private
               DEFAULT_ENDPOINT_TEMPLATE = "run.$UNIVERSE_DOMAIN$"
 
@@ -224,12 +227,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.get_task.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::Run::V2::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.get_task.timeout,
@@ -316,12 +320,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.list_tasks.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::Run::V2::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.list_tasks.timeout,

data/lib/google/cloud/run/v2/vendor_settings_pb.rb

@@ -4,10 +4,11 @@
 
 require 'google/protobuf'
 
+require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 
 
-descriptor_data = "\n)google/cloud/run/v2/vendor_settings.proto\x12\x13google.cloud.run.v2\x1a\x19google/api/resource.proto\"\xe8\x02\n\tVpcAccess\x12:\n\tconnector\x18\x01 \x01(\tB\'\xfa\x41$\n\"vpcaccess.googleapis.com/Connector\x12\x38\n\x06\x65gress\x18\x02 \x01(\x0e\x32(.google.cloud.run.v2.VpcAccess.VpcEgress\x12K\n\x12network_interfaces\x18\x03 \x03(\x0b\x32/.google.cloud.run.v2.VpcAccess.NetworkInterface\x1a\x45\n\x10NetworkInterface\x12\x0f\n\x07network\x18\x01 \x01(\t\x12\x12\n\nsubnetwork\x18\x02 \x01(\t\x12\x0c\n\x04tags\x18\x03 \x03(\t\"Q\n\tVpcEgress\x12\x1a\n\x16VPC_EGRESS_UNSPECIFIED\x10\x00\x12\x0f\n\x0b\x41LL_TRAFFIC\x10\x01\x12\x17\n\x13PRIVATE_RANGES_ONLY\x10\x02\"a\n\x13\x42inaryAuthorization\x12\x15\n\x0buse_default\x18\x01 \x01(\x08H\x00\x12 \n\x18\x62reakglass_justification\x18\x02 \x01(\tB\x11\n\x0f\x62inauthz_method\"I\n\x0fRevisionScaling\x12\x1a\n\x12min_instance_count\x18\x01 \x01(\x05\x12\x1a\n\x12max_instance_count\x18\x02 \x01(\x05\",\n\x0eServiceScaling\x12\x1a\n\x12min_instance_count\x18\x01 \x01(\x05*\x99\x01\n\x0eIngressTraffic\x12\x1f\n\x1bINGRESS_TRAFFIC_UNSPECIFIED\x10\x00\x12\x17\n\x13INGRESS_TRAFFIC_ALL\x10\x01\x12!\n\x1dINGRESS_TRAFFIC_INTERNAL_ONLY\x10\x02\x12*\n&INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER\x10\x03*}\n\x14\x45xecutionEnvironment\x12%\n!EXECUTION_ENVIRONMENT_UNSPECIFIED\x10\x00\x12\x1e\n\x1a\x45XECUTION_ENVIRONMENT_GEN1\x10\x01\x12\x1e\n\x1a\x45XECUTION_ENVIRONMENT_GEN2\x10\x02*p\n\x1d\x45ncryptionKeyRevocationAction\x12\x30\n,ENCRYPTION_KEY_REVOCATION_ACTION_UNSPECIFIED\x10\x00\x12\x0f\n\x0bPREVENT_NEW\x10\x01\x12\x0c\n\x08SHUTDOWN\x10\x02\x42[\n\x17\x63om.google.cloud.run.v2B\x13VendorSettingsProtoP\x01Z)cloud.google.com/go/run/apiv2/runpb;runpbb\x06proto3"
+descriptor_data = "\n)google/cloud/run/v2/vendor_settings.proto\x12\x13google.cloud.run.v2\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\"\x81\x03\n\tVpcAccess\x12:\n\tconnector\x18\x01 \x01(\tB\'\xfa\x41$\n\"vpcaccess.googleapis.com/Connector\x12=\n\x06\x65gress\x18\x02 \x01(\x0e\x32(.google.cloud.run.v2.VpcAccess.VpcEgressB\x03\xe0\x41\x01\x12P\n\x12network_interfaces\x18\x03 \x03(\x0b\x32/.google.cloud.run.v2.VpcAccess.NetworkInterfaceB\x03\xe0\x41\x01\x1aT\n\x10NetworkInterface\x12\x14\n\x07network\x18\x01 \x01(\tB\x03\xe0\x41\x01\x12\x17\n\nsubnetwork\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x11\n\x04tags\x18\x03 \x03(\tB\x03\xe0\x41\x01\"Q\n\tVpcEgress\x12\x1a\n\x16VPC_EGRESS_UNSPECIFIED\x10\x00\x12\x0f\n\x0b\x41LL_TRAFFIC\x10\x01\x12\x17\n\x13PRIVATE_RANGES_ONLY\x10\x02\"\x82\x01\n\x13\x42inaryAuthorization\x12\x1a\n\x0buse_default\x18\x01 \x01(\x08\x42\x03\xe0\x41\x01H\x00\x12\x15\n\x06policy\x18\x03 \x01(\tB\x03\xe0\x41\x01H\x00\x12%\n\x18\x62reakglass_justification\x18\x02 \x01(\tB\x03\xe0\x41\x01\x42\x11\n\x0f\x62inauthz_method\"S\n\x0fRevisionScaling\x12\x1f\n\x12min_instance_count\x18\x01 \x01(\x05\x42\x03\xe0\x41\x01\x12\x1f\n\x12max_instance_count\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\"1\n\x0eServiceScaling\x12\x1f\n\x12min_instance_count\x18\x01 \x01(\x05\x42\x03\xe0\x41\x01*\x99\x01\n\x0eIngressTraffic\x12\x1f\n\x1bINGRESS_TRAFFIC_UNSPECIFIED\x10\x00\x12\x17\n\x13INGRESS_TRAFFIC_ALL\x10\x01\x12!\n\x1dINGRESS_TRAFFIC_INTERNAL_ONLY\x10\x02\x12*\n&INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER\x10\x03*}\n\x14\x45xecutionEnvironment\x12%\n!EXECUTION_ENVIRONMENT_UNSPECIFIED\x10\x00\x12\x1e\n\x1a\x45XECUTION_ENVIRONMENT_GEN1\x10\x01\x12\x1e\n\x1a\x45XECUTION_ENVIRONMENT_GEN2\x10\x02*p\n\x1d\x45ncryptionKeyRevocationAction\x12\x30\n,ENCRYPTION_KEY_REVOCATION_ACTION_UNSPECIFIED\x10\x00\x12\x0f\n\x0bPREVENT_NEW\x10\x01\x12\x0c\n\x08SHUTDOWN\x10\x02\x42[\n\x17\x63om.google.cloud.run.v2B\x13VendorSettingsProtoP\x01Z)cloud.google.com/go/run/apiv2/runpb;runpbb\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Run
       module V2
-        VERSION = "0.15.0"
+        VERSION = "0.16.1"
       end
     end
   end

data/proto_docs/google/api/client.rb

@@ -118,6 +118,10 @@ module Google
     #   @return [::String]
     #     Optional link to proto reference documentation.  Example:
     #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
+    # @!attribute [rw] rest_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to REST reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rest
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -192,9 +196,26 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] experimental_features
+    #   @return [::Google::Api::PythonSettings::ExperimentalFeatures]
+    #     Experimental features to be included during client library generation.
     class PythonSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Experimental features to be included during client library generation.
+      # These fields will be deprecated once the feature graduates and is enabled
+      # by default.
+      # @!attribute [rw] rest_async_io_enabled
+      #   @return [::Boolean]
+      #     Enables generation of asynchronous REST clients if `rest` transport is
+      #     enabled. By default, asynchronous REST clients will not be generated.
+      #     This feature will be enabled by default 1 month after launching the
+      #     feature in preview packages.
+      class ExperimentalFeatures
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Node client libraries.
@@ -286,6 +307,13 @@ module Google
     #   @return [::String]
     #     The fully qualified name of the method, for which the options below apply.
     #     This is used to find the method to apply the options.
+    #
+    #     Example:
+    #
+    #        publishing:
+    #          method_settings:
+    #          - selector: google.storage.control.v2.StorageControl.CreateFolder
+    #            # method settings for CreateFolder...
     # @!attribute [rw] long_running
     #   @return [::Google::Api::MethodSettings::LongRunning]
     #     Describes settings to use for long-running operations when generating
@@ -294,17 +322,14 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
-    #              initial_poll_delay:
-    #                seconds: 60 # 1 minute
+    #              initial_poll_delay: 60s # 1 minute
     #              poll_delay_multiplier: 1.5
-    #              max_poll_delay:
-    #                seconds: 360 # 6 minutes
-    #              total_poll_timeout:
-    #                 seconds: 54000 # 90 minutes
+    #              max_poll_delay: 360s # 6 minutes
+    #              total_poll_timeout: 54000s # 90 minutes
     # @!attribute [rw] auto_populated_fields
     #   @return [::Array<::String>]
     #     List of top-level fields of the request message, that should be
@@ -313,8 +338,8 @@ module Google
     #
     #     Example of a YAML configuration:
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.example.v1.ExampleService.CreateExample
     #            auto_populated_fields:
     #            - request_id

data/proto_docs/google/api/resource.rb

@@ -124,8 +124,13 @@ module Google
     #   @return [::String]
     #     The plural name used in the resource name and permission names, such as
     #     'projects' for the resource name of 'projects/\\{project}' and the permission
-    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
-    #     concept of the `plural` field in k8s CRD spec
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
+    #     to this is for Nested Collections that have stuttering names, as defined
+    #     in [AIP-122](https://google.aip.dev/122#nested-collections), where the
+    #     collection ID in the resource name pattern does not necessarily directly
+    #     match the `plural` value.
+    #
+    #     It is the same concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #
     #     Note: The plural form is required even for singleton resources. See

data/proto_docs/google/cloud/run/v2/condition.rb

@@ -41,15 +41,15 @@ module Google
         # @!attribute [rw] severity
         #   @return [::Google::Cloud::Run::V2::Condition::Severity]
         #     How to interpret failures of this condition, one of Error, Warning, Info
-        # @!attribute [rw] reason
+        # @!attribute [r] reason
         #   @return [::Google::Cloud::Run::V2::Condition::CommonReason]
-        #     A common (service-level) reason for this condition.
-        # @!attribute [rw] revision_reason
+        #     Output only. A common (service-level) reason for this condition.
+        # @!attribute [r] revision_reason
         #   @return [::Google::Cloud::Run::V2::Condition::RevisionReason]
-        #     A reason for the revision condition.
-        # @!attribute [rw] execution_reason
+        #     Output only. A reason for the revision condition.
+        # @!attribute [r] execution_reason
         #   @return [::Google::Cloud::Run::V2::Condition::ExecutionReason]
-        #     A reason for the execution condition.
+        #     Output only. A reason for the execution condition.
         class Condition
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/run/v2/job.rb

@@ -64,9 +64,9 @@ module Google
         #     populated, without persisting the request or updating any resources.
         # @!attribute [rw] allow_missing
         #   @return [::Boolean]
-        #     If set to true, and if the Job does not exist, it will create a new
-        #     one. Caller must have both create and update permissions for this call if
-        #     this is set to true.
+        #     Optional. If set to true, and if the Job does not exist, it will create a
+        #     new one. Caller must have both create and update permissions for this call
+        #     if this is set to true.
         class UpdateJobRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -239,7 +239,8 @@ module Google
         #     Output only. The last-modified time.
         # @!attribute [r] delete_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The deletion time.
+        #     Output only. The deletion time. It is only populated as a response to a
+        #     Delete request.
         # @!attribute [r] expire_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. For a deleted resource, the time after which it will be
@@ -320,6 +321,16 @@ module Google
         # @!attribute [r] satisfies_pzs
         #   @return [::Boolean]
         #     Output only. Reserved for future use.
+        # @!attribute [rw] start_execution_token
+        #   @return [::String]
+        #     A unique string used as a suffix creating a new execution. The Job will
+        #     become ready when the execution is successfully started.
+        #     The sum of job name and token length must be fewer than 63 characters.
+        # @!attribute [rw] run_execution_token
+        #   @return [::String]
+        #     A unique string used as a suffix for creating a new execution. The Job
+        #     will become ready when the execution is successfully completed.
+        #     The sum of job name and token length must be fewer than 63 characters.
         # @!attribute [r] etag
         #   @return [::String]
         #     Output only. A system-generated fingerprint for this version of the
@@ -358,9 +369,37 @@ module Google
         # @!attribute [rw] completion_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Creation timestamp of the execution.
+        # @!attribute [rw] delete_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The deletion time of the execution. It is only
+        #     populated as a response to a Delete request.
+        # @!attribute [rw] completion_status
+        #   @return [::Google::Cloud::Run::V2::ExecutionReference::CompletionStatus]
+        #     Status for the execution completion.
         class ExecutionReference
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Possible execution completion status.
+          module CompletionStatus
+            # The default value. This value is used if the state is omitted.
+            COMPLETION_STATUS_UNSPECIFIED = 0
+
+            # Job execution has succeeded.
+            EXECUTION_SUCCEEDED = 1
+
+            # Job execution has failed.
+            EXECUTION_FAILED = 2
+
+            # Job execution is running normally.
+            EXECUTION_RUNNING = 3
+
+            # Waiting for backing resources to be provisioned.
+            EXECUTION_PENDING = 4
+
+            # Job execution has been cancelled by the user.
+            EXECUTION_CANCELLED = 5
+          end
         end
       end
     end

data/proto_docs/google/cloud/run/v2/k8s.min.rb

@@ -354,19 +354,20 @@ module Google
         #     Path that is exported by the NFS server.
         # @!attribute [rw] read_only
         #   @return [::Boolean]
-        #     If true, mount the NFS volume as read only
+        #     If true, the volume will be mounted as read only for all mounts.
         class NFSVolumeSource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Represents a GCS Bucket mounted as a volume.
+        # Represents a volume backed by a Cloud Storage bucket using Cloud Storage
+        # FUSE.
         # @!attribute [rw] bucket
         #   @return [::String]
-        #     GCS Bucket name
+        #     Cloud Storage Bucket name.
         # @!attribute [rw] read_only
         #   @return [::Boolean]
-        #     If true, mount the GCS bucket as read-only
+        #     If true, the volume will be mounted as read only for all mounts.
         class GCSVolumeSource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -376,36 +377,35 @@ module Google
         # determine whether it is alive or ready to receive traffic.
         # @!attribute [rw] initial_delay_seconds
         #   @return [::Integer]
-        #     Number of seconds after the container has started before the probe is
-        #     initiated.
-        #     Defaults to 0 seconds. Minimum value is 0. Maximum value for liveness probe
-        #     is 3600. Maximum value for startup probe is 240.
+        #     Optional. Number of seconds after the container has started before the
+        #     probe is initiated. Defaults to 0 seconds. Minimum value is 0. Maximum
+        #     value for liveness probe is 3600. Maximum value for startup probe is 240.
         # @!attribute [rw] timeout_seconds
         #   @return [::Integer]
-        #     Number of seconds after which the probe times out.
+        #     Optional. Number of seconds after which the probe times out.
         #     Defaults to 1 second. Minimum value is 1. Maximum value is 3600.
         #     Must be smaller than period_seconds.
         # @!attribute [rw] period_seconds
         #   @return [::Integer]
-        #     How often (in seconds) to perform the probe.
+        #     Optional. How often (in seconds) to perform the probe.
         #     Default to 10 seconds. Minimum value is 1. Maximum value for liveness probe
         #     is 3600. Maximum value for startup probe is 240.
         #     Must be greater or equal than timeout_seconds.
         # @!attribute [rw] failure_threshold
         #   @return [::Integer]
-        #     Minimum consecutive failures for the probe to be considered failed after
-        #     having succeeded. Defaults to 3. Minimum value is 1.
+        #     Optional. Minimum consecutive failures for the probe to be considered
+        #     failed after having succeeded. Defaults to 3. Minimum value is 1.
         # @!attribute [rw] http_get
         #   @return [::Google::Cloud::Run::V2::HTTPGetAction]
-        #     HTTPGet specifies the http request to perform.
+        #     Optional. HTTPGet specifies the http request to perform.
         #     Exactly one of httpGet, tcpSocket, or grpc must be specified.
         # @!attribute [rw] tcp_socket
         #   @return [::Google::Cloud::Run::V2::TCPSocketAction]
-        #     TCPSocket specifies an action involving a TCP port.
+        #     Optional. TCPSocket specifies an action involving a TCP port.
         #     Exactly one of httpGet, tcpSocket, or grpc must be specified.
         # @!attribute [rw] grpc
         #   @return [::Google::Cloud::Run::V2::GRPCAction]
-        #     GRPC specifies an action involving a gRPC port.
+        #     Optional. GRPC specifies an action involving a gRPC port.
         #     Exactly one of httpGet, tcpSocket, or grpc must be specified.
         class Probe
           include ::Google::Protobuf::MessageExts
@@ -415,15 +415,16 @@ module Google
         # HTTPGetAction describes an action based on HTTP Get requests.
         # @!attribute [rw] path
         #   @return [::String]
-        #     Path to access on the HTTP server. Defaults to '/'.
+        #     Optional. Path to access on the HTTP server. Defaults to '/'.
         # @!attribute [rw] http_headers
         #   @return [::Array<::Google::Cloud::Run::V2::HTTPHeader>]
-        #     Custom headers to set in the request. HTTP allows repeated headers.
+        #     Optional. Custom headers to set in the request. HTTP allows repeated
+        #     headers.
         # @!attribute [rw] port
         #   @return [::Integer]
-        #     Port number to access on the container. Must be in the range 1 to 65535.
-        #     If not specified, defaults to the exposed port of the container, which is
-        #     the value of container.ports[0].containerPort.
+        #     Optional. Port number to access on the container. Must be in the range 1 to
+        #     65535. If not specified, defaults to the exposed port of the container,
+        #     which is the value of container.ports[0].containerPort.
         class HTTPGetAction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -435,7 +436,7 @@ module Google
         #     Required. The header field name
         # @!attribute [rw] value
         #   @return [::String]
-        #     The header field value
+        #     Optional. The header field value
         class HTTPHeader
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -444,9 +445,9 @@ module Google
         # TCPSocketAction describes an action based on opening a socket
         # @!attribute [rw] port
         #   @return [::Integer]
-        #     Port number to access on the container. Must be in the range 1 to 65535.
-        #     If not specified, defaults to the exposed port of the container, which is
-        #     the value of container.ports[0].containerPort.
+        #     Optional. Port number to access on the container. Must be in the range 1 to
+        #     65535. If not specified, defaults to the exposed port of the container,
+        #     which is the value of container.ports[0].containerPort.
         class TCPSocketAction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -455,14 +456,15 @@ module Google
         # GRPCAction describes an action involving a GRPC port.
         # @!attribute [rw] port
         #   @return [::Integer]
-        #     Port number of the gRPC service. Number must be in the range 1 to 65535.
-        #     If not specified, defaults to the exposed port of the container, which is
-        #     the value of container.ports[0].containerPort.
+        #     Optional. Port number of the gRPC service. Number must be in the range 1 to
+        #     65535. If not specified, defaults to the exposed port of the container,
+        #     which is the value of container.ports[0].containerPort.
         # @!attribute [rw] service
         #   @return [::String]
-        #     Service is the name of the service to place in the gRPC HealthCheckRequest
-        #     (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md ). If
-        #     this is not specified, the default behavior is defined by gRPC.
+        #     Optional. Service is the name of the service to place in the gRPC
+        #     HealthCheckRequest (see
+        #     https://github.com/grpc/grpc/blob/master/doc/health-checking.md ). If this
+        #     is not specified, the default behavior is defined by gRPC.
         class GRPCAction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/run/v2/revision_template.rb

@@ -25,15 +25,14 @@ module Google
         # a template.
         # @!attribute [rw] revision
         #   @return [::String]
-        #     The unique name for the revision. If this field is omitted, it will be
-        #     automatically generated based on the Service name.
+        #     Optional. The unique name for the revision. If this field is omitted, it
+        #     will be automatically generated based on the Service name.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Unstructured key value map that can be used to organize and categorize
-        #     objects.
-        #     User-provided labels are shared with Google's billing system, so they can
-        #     be used to filter, or break down billing charges by team, component,
-        #     environment, state, etc. For more information, visit
+        #     Optional. Unstructured key value map that can be used to organize and
+        #     categorize objects. User-provided labels are shared with Google's billing
+        #     system, so they can be used to filter, or break down billing charges by
+        #     team, component, environment, state, etc. For more information, visit
         #     https://cloud.google.com/resource-manager/docs/creating-managing-labels or
         #     https://cloud.google.com/run/docs/configuring/labels.
         #
@@ -43,9 +42,9 @@ module Google
         #     corresponding field in v2 RevisionTemplate.
         # @!attribute [rw] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Unstructured key value map that may be set by external tools to store and
-        #     arbitrary metadata. They are not queryable and should be preserved
-        #     when modifying objects.
+        #     Optional. Unstructured key value map that may be set by external tools to
+        #     store and arbitrary metadata. They are not queryable and should be
+        #     preserved when modifying objects.
         #
         #     <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -56,19 +55,20 @@ module Google
         #     rules.
         # @!attribute [rw] scaling
         #   @return [::Google::Cloud::Run::V2::RevisionScaling]
-        #     Scaling settings for this Revision.
+        #     Optional. Scaling settings for this Revision.
         # @!attribute [rw] vpc_access
         #   @return [::Google::Cloud::Run::V2::VpcAccess]
-        #     VPC Access configuration to use for this Revision. For more information,
-        #     visit https://cloud.google.com/run/docs/configuring/connecting-vpc.
+        #     Optional. VPC Access configuration to use for this Revision. For more
+        #     information, visit
+        #     https://cloud.google.com/run/docs/configuring/connecting-vpc.
         # @!attribute [rw] timeout
         #   @return [::Google::Protobuf::Duration]
-        #     Max allowed time for an instance to respond to a request.
+        #     Optional. Max allowed time for an instance to respond to a request.
         # @!attribute [rw] service_account
         #   @return [::String]
-        #     Email address of the IAM service account associated with the revision of
-        #     the service. The service account represents the identity of the running
-        #     revision, and determines what permissions the revision has. If not
+        #     Optional. Email address of the IAM service account associated with the
+        #     revision of the service. The service account represents the identity of the
+        #     running revision, and determines what permissions the revision has. If not
         #     provided, the revision will use the project's default service account.
         # @!attribute [rw] containers
         #   @return [::Array<::Google::Cloud::Run::V2::Container>]
@@ -76,10 +76,10 @@ module Google
         #     Revision.
         # @!attribute [rw] volumes
         #   @return [::Array<::Google::Cloud::Run::V2::Volume>]
-        #     A list of Volumes to make available to containers.
+        #     Optional. A list of Volumes to make available to containers.
         # @!attribute [rw] execution_environment
         #   @return [::Google::Cloud::Run::V2::ExecutionEnvironment]
-        #     The sandbox environment to host this Revision.
+        #     Optional. The sandbox environment to host this Revision.
         # @!attribute [rw] encryption_key
         #   @return [::String]
         #     A reference to a customer managed encryption key (CMEK) to use to encrypt
@@ -87,7 +87,8 @@ module Google
         #     https://cloud.google.com/run/docs/securing/using-cmek
         # @!attribute [rw] max_instance_request_concurrency
         #   @return [::Integer]
-        #     Sets the maximum number of requests that each serving instance can receive.
+        #     Optional. Sets the maximum number of requests that each serving instance
+        #     can receive.
         # @!attribute [rw] session_affinity
         #   @return [::Boolean]
         #     Optional. Enable session affinity.

data/proto_docs/google/cloud/run/v2/service.rb

@@ -45,6 +45,9 @@ module Google
         end
 
         # Request message for updating a service.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. The list of fields to be updated.
         # @!attribute [rw] service
         #   @return [::Google::Cloud::Run::V2::Service]
         #     Required. The Service to be updated.
@@ -54,9 +57,9 @@ module Google
         #     populated, without persisting the request or updating any resources.
         # @!attribute [rw] allow_missing
         #   @return [::Boolean]
-        #     If set to true, and if the Service does not exist, it will create a new
-        #     one. The caller must have 'run.services.create' permissions if this is set
-        #     to true and the Service does not exist.
+        #     Optional. If set to true, and if the Service does not exist, it will create
+        #     a new one. The caller must have 'run.services.create' permissions if this
+        #     is set to true and the Service does not exist.
         class UpdateServiceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -189,7 +192,8 @@ module Google
         #     Output only. The last-modified time.
         # @!attribute [r] delete_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The deletion time.
+        #     Output only. The deletion time. It is only populated as a response to a
+        #     Delete request.
         # @!attribute [r] expire_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. For a deleted resource, the time after which it will be
@@ -208,12 +212,12 @@ module Google
         #     Arbitrary version identifier for the API client.
         # @!attribute [rw] ingress
         #   @return [::Google::Cloud::Run::V2::IngressTraffic]
-        #     Provides the ingress settings for this Service. On output, returns the
-        #     currently observed ingress settings, or INGRESS_TRAFFIC_UNSPECIFIED if no
-        #     revision is active.
+        #     Optional. Provides the ingress settings for this Service. On output,
+        #     returns the currently observed ingress settings, or
+        #     INGRESS_TRAFFIC_UNSPECIFIED if no revision is active.
         # @!attribute [rw] launch_stage
         #   @return [::Google::Api::LaunchStage]
-        #     The launch stage as defined by [Google Cloud Platform
+        #     Optional. The launch stage as defined by [Google Cloud Platform
         #     Launch Stages](https://cloud.google.com/terms/launch-stages).
         #     Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA
         #     is assumed.
@@ -225,15 +229,15 @@ module Google
         #     features are used, this field will be BETA on output.
         # @!attribute [rw] binary_authorization
         #   @return [::Google::Cloud::Run::V2::BinaryAuthorization]
-        #     Settings for the Binary Authorization feature.
+        #     Optional. Settings for the Binary Authorization feature.
         # @!attribute [rw] template
         #   @return [::Google::Cloud::Run::V2::RevisionTemplate]
         #     Required. The template used to create revisions for this Service.
         # @!attribute [rw] traffic
         #   @return [::Array<::Google::Cloud::Run::V2::TrafficTarget>]
-        #     Specifies how to distribute traffic over a collection of Revisions
-        #     belonging to the Service. If traffic is empty or not provided, defaults to
-        #     100% traffic to the latest `Ready` Revision.
+        #     Optional. Specifies how to distribute traffic over a collection of
+        #     Revisions belonging to the Service. If traffic is empty or not provided,
+        #     defaults to 100% traffic to the latest `Ready` Revision.
         # @!attribute [rw] scaling
         #   @return [::Google::Cloud::Run::V2::ServiceScaling]
         #     Optional. Specifies service-level scaling settings