google-cloud-run-v2 0.6.0 → 0.8.0

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Run
       module V2
-        VERSION = "0.6.0"
+        VERSION = "0.8.0"
       end
     end
   end

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

@@ -34,6 +34,11 @@ module Google
       #     require "google/cloud/run/v2"
       #     client = ::Google::Cloud::Run::V2::Executions::Client.new
       #
+      # @example Load this package, including all its services, and instantiate a REST client
+      #
+      #     require "google/cloud/run/v2"
+      #     client = ::Google::Cloud::Run::V2::Executions::Rest::Client.new
+      #
       module V2
       end
     end

data/proto_docs/google/api/client.rb

@@ -35,7 +35,9 @@ module Google
     # Details about how and where to publish client libraries.
     # @!attribute [rw] version
     #   @return [::String]
-    #     Version of the API to apply these settings to.
+    #     Version of the API to apply these settings to. This is the full protobuf
+    #     package for the API, ending in the version element.
+    #     Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
     # @!attribute [rw] launch_stage
     #   @return [::Google::Api::LaunchStage]
     #     Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
     #     long-running operation pattern.
     # @!attribute [rw] new_issue_uri
     #   @return [::String]
-    #     Link to a place that API users can report issues.  Example:
+    #     Link to a *public* URI where users can report issues.  Example:
     #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
     # @!attribute [rw] documentation_uri
     #   @return [::String]
@@ -111,6 +113,10 @@ module Google
     #     Client library settings.  If the same version string appears multiple
     #     times in this list, then the last one wins.  Settings from earlier
     #     settings with the same version string are discarded.
+    # @!attribute [rw] proto_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to proto reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from original service names to renamed versions.
+    #     This is used when the default generated types
+    #     would cause a naming conflict. (Neither name is
+    #     fully-qualified.)
+    #     Example: Subscriber to SubscriberServiceApi.
+    # @!attribute [rw] renamed_resources
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from full resource types to the effective short name
+    #     for the resource. This is used when otherwise resource
+    #     named from different services would cause naming collisions.
+    #     Example entry:
+    #     "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
+    # @!attribute [rw] ignored_resources
+    #   @return [::Array<::String>]
+    #     List of full resource types to ignore during generation.
+    #     This is typically used for API-specific Location resources,
+    #     which should be handled by the generator as if they were actually
+    #     the common Location resources.
+    #     Example entry: "documentai.googleapis.com/Location"
+    # @!attribute [rw] forced_namespace_aliases
+    #   @return [::Array<::String>]
+    #     Namespaces which must be aliased in snippets due to
+    #     a known (but non-generator-predictable) naming collision
+    # @!attribute [rw] handwritten_signatures
+    #   @return [::Array<::String>]
+    #     Method signatures (in the form "service.method(signature)")
+    #     which are provided separately, so shouldn't be generated.
+    #     Snippets *calling* these methods are still generated, however.
     class DotnetSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedResourcesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
     #     Example of a YAML configuration::
     #
     #      publishing:
-    #        method_behavior:
-    #          - selector: CreateAdDomain
+    #        method_settings:
+    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
     #              initial_poll_delay:
     #                seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
 
       # Street View Org.
       STREET_VIEW = 4
+
+      # Shopping Org.
+      SHOPPING = 5
+
+      # Geo Org.
+      GEO = 6
+
+      # Generative AI - https://developers.generativeai.google
+      GENERATIVE_AI = 7
     end
 
     # To where should client libraries be published?

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

@@ -198,6 +198,9 @@ module Google
 
             # The execution was cancelled by users.
             CANCELLED = 3
+
+            # The execution is in the process of being cancelled.
+            CANCELLING = 4
           end
         end
       end

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

@@ -103,17 +103,20 @@ module Google
         #   @return [::Integer]
         #     Output only. A number that monotonically increases every time the user
         #     modifies the desired state.
-        # @!attribute [rw] labels
+        # @!attribute [r] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style labels for the resource.
-        #     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
+        #     Output only. 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
-        # @!attribute [rw] annotations
+        # @!attribute [r] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style annotations for the resource.
+        #     Output only. 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.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Represents time when the execution was acknowledged by the
@@ -142,10 +145,14 @@ module Google
         #     request.
         # @!attribute [rw] launch_stage
         #   @return [::Google::Api::LaunchStage]
-        #     Set the launch stage to a preview stage on write to allow use of preview
-        #     features in that stage. On read, describes whether the resource uses
-        #     preview features. Launch Stages are defined at [Google Cloud Platform
-        #     Launch Stages](https://cloud.google.com/terms/launch-stages).
+        #     The least stable launch stage needed to create this resource, as defined by
+        #     [Google Cloud Platform Launch
+        #     Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports
+        #     `ALPHA`, `BETA`, and `GA`.
+        #     <p>Note that this value might not be what was used
+        #     as input. For example, if ALPHA was provided as input in the parent
+        #     resource, but only BETA and GA-level features are were, this field will be
+        #     BETA.
         # @!attribute [r] job
         #   @return [::String]
         #     Output only. The name of the parent Job.
@@ -155,15 +162,12 @@ module Google
         #     should run at any given time. Must be <= task_count. The actual number of
         #     tasks running in steady state will be less than this number when
         #     ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when
-        #     the work left to do is less than max parallelism. More info:
-        #     https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+        #     the work left to do is less than max parallelism.
         # @!attribute [r] task_count
         #   @return [::Integer]
         #     Output only. Specifies the desired number of tasks the execution should
         #     run. Setting to 1 means that parallelism is limited to 1 and the success of
         #     that task signals the success of the execution.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
         # @!attribute [r] template
         #   @return [::Google::Cloud::Run::V2::TaskTemplate]
         #     Output only. The template used to create tasks for this execution.
@@ -201,6 +205,9 @@ module Google
         #   @return [::String]
         #     Output only. URI where logs for this execution can be found in Cloud
         #     Console.
+        # @!attribute [r] satisfies_pzs
+        #   @return [::Boolean]
+        #     Output only. Reserved for future use.
         # @!attribute [r] etag
         #   @return [::String]
         #     Output only. A system-generated fingerprint for this version of the

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

@@ -25,7 +25,13 @@ module Google
         # from a template.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style labels for the resource.
+        #     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.
         #
         #     <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -33,12 +39,17 @@ module Google
         #     corresponding field in v2 ExecutionTemplate.
         # @!attribute [rw] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style annotations for the resource.
+        #     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`
         #     namespaces, and they will be rejected. All system annotations in v1 now
         #     have a corresponding field in v2 ExecutionTemplate.
+        #
+        #     <p>This field follows Kubernetes annotations' namespacing, limits, and
+        #     rules.
         # @!attribute [rw] parallelism
         #   @return [::Integer]
         #     Specifies the maximum desired number of tasks the execution should run at
@@ -52,9 +63,7 @@ module Google
         #   @return [::Integer]
         #     Specifies the desired number of tasks the execution should run.
         #     Setting to 1 means that parallelism is limited to 1 and the success of
-        #     that task signals the success of the execution.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+        #     that task signals the success of the execution. Defaults to 1.
         # @!attribute [rw] template
         #   @return [::Google::Cloud::Run::V2::TaskTemplate]
         #     Required. Describes the task(s) that will be created when executing an

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

@@ -163,12 +163,13 @@ module Google
         #     modifies the desired state.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style labels for the resource.
+        #     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
+        #     https://cloud.google.com/run/docs/configuring/labels.
         #
         #     <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -176,18 +177,18 @@ module Google
         #     corresponding field in v2 Job.
         # @!attribute [rw] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style annotations for the resource. Unstructured key value map that may
+        #     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`
-        #     namespaces, and they will be rejected. All system annotations in v1 now
-        #     have a corresponding field in v2 Job.
+        #     namespaces, and they will be rejected on new resources. All system
+        #     annotations in v1 now have a corresponding field in v2 Job.
         #
         #     <p>This field follows Kubernetes annotations' namespacing, limits, and
-        #     rules. More info: https://kubernetes.io/docs/user-guide/annotations
+        #     rules.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The creation time.
@@ -219,6 +220,12 @@ module Google
         #     Launch Stages](https://cloud.google.com/terms/launch-stages).
         #     Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA
         #     is assumed.
+        #     Set the launch stage to a preview stage on input to allow use of preview
+        #     features in that stage. On read (or output), describes whether the resource
+        #     uses preview features.
+        #     <p>
+        #     For example, if ALPHA is provided as input, but only BETA and GA-level
+        #     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.
@@ -268,6 +275,9 @@ module Google
         #     `latest_succeeded_execution` will have the state of the last succeeded
         #     execution or empty for newly created Job. Additional information on the
         #     failure can be found in `terminal_condition` and `conditions`.
+        # @!attribute [r] satisfies_pzs
+        #   @return [::Boolean]
+        #     Output only. Reserved for future use.
         # @!attribute [r] etag
         #   @return [::String]
         #     Output only. A system-generated fingerprint for this version of the

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

@@ -33,38 +33,21 @@ module Google
         #   @return [::String]
         #     Required. Name of the container image in Dockerhub, Google Artifact
         #     Registry, or Google Container Registry. If the host is not provided,
-        #     Dockerhub is assumed. More info:
-        #     https://kubernetes.io/docs/concepts/containers/images
+        #     Dockerhub is assumed.
         # @!attribute [rw] command
         #   @return [::Array<::String>]
         #     Entrypoint array. Not executed within a shell.
         #     The docker image's ENTRYPOINT is used if this is not provided.
-        #     Variable references $(VAR_NAME) are expanded using the container's
-        #     environment. If a variable cannot be resolved, the reference in the input
-        #     string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
-        #     double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
-        #     regardless of whether the variable exists or not.
-        #     More info:
-        #     https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
         # @!attribute [rw] args
         #   @return [::Array<::String>]
         #     Arguments to the entrypoint.
         #     The docker image's CMD is used if this is not provided.
-        #     Variable references $(VAR_NAME) are expanded using the container's
-        #     environment. If a variable cannot be resolved, the reference in the input
-        #     string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
-        #     double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
-        #     regardless of whether the variable exists or not.
-        #     More info:
-        #     https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
         # @!attribute [rw] env
         #   @return [::Array<::Google::Cloud::Run::V2::EnvVar>]
         #     List of environment variables to set in the container.
         # @!attribute [rw] resources
         #   @return [::Google::Cloud::Run::V2::ResourceRequirements]
         #     Compute Resource requirements by this container.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
         # @!attribute [rw] ports
         #   @return [::Array<::Google::Cloud::Run::V2::ContainerPort>]
         #     List of ports to expose from the container. Only a single port can be
@@ -85,16 +68,12 @@ module Google
         #   @return [::Google::Cloud::Run::V2::Probe]
         #     Periodic probe of container liveness.
         #     Container will be restarted if the probe fails.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
         # @!attribute [rw] startup_probe
         #   @return [::Google::Cloud::Run::V2::Probe]
         #     Startup probe of application within the container.
         #     All other probes are disabled if a startup probe is provided, until it
         #     succeeds. Container will not be added to service endpoints if the probe
         #     fails.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
         class Container
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -103,14 +82,22 @@ module Google
         # ResourceRequirements describes the compute resource requirements.
         # @!attribute [rw] limits
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Only memory and CPU are supported. Note: The only
-        #     supported values for CPU are '1', '2',  '4', and '8'. Setting 4 CPU
-        #     requires at least 2Gi of memory. The values of the map is string form of
-        #     the 'quantity' k8s type:
-        #     https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
+        #     Only ´memory´ and 'cpu' are supported.
+        #
+        #     <p>Notes:
+        #      * The only supported values for CPU are '1', '2', '4', and '8'. Setting 4
+        #     CPU requires at least 2Gi of memory. For more information, go to
+        #     https://cloud.google.com/run/docs/configuring/cpu.
+        #       * For supported 'memory' values and syntax, go to
+        #      https://cloud.google.com/run/docs/configuring/memory-limits
         # @!attribute [rw] cpu_idle
         #   @return [::Boolean]
         #     Determines whether CPU should be throttled or not outside of requests.
+        # @!attribute [rw] startup_cpu_boost
+        #   @return [::Boolean]
+        #     Determines whether CPU should be boosted on startup of a new container
+        #     instance above the requested CPU threshold, this can help reduce cold-start
+        #     latency.
         class ResourceRequirements
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,7 +198,6 @@ module Google
         # @!attribute [rw] secret
         #   @return [::Google::Cloud::Run::V2::SecretVolumeSource]
         #     Secret represents a secret that should populate this volume.
-        #     More info: https://kubernetes.io/docs/concepts/storage/volumes#secret
         # @!attribute [rw] cloud_sql_instance
         #   @return [::Google::Cloud::Run::V2::CloudSqlInstance]
         #     For Cloud SQL volumes, contains the specific instances that should be
@@ -319,15 +305,11 @@ module Google
         #     initiated.
         #     Defaults to 0 seconds. Minimum value is 0. Maximum value for liveness probe
         #     is 3600. Maximum value for startup probe is 240.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
         # @!attribute [rw] timeout_seconds
         #   @return [::Integer]
         #     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.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
         # @!attribute [rw] period_seconds
         #   @return [::Integer]
         #     How often (in seconds) to perform the probe.
@@ -362,6 +344,11 @@ module Google
         # @!attribute [rw] http_headers
         #   @return [::Array<::Google::Cloud::Run::V2::HTTPHeader>]
         #     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.
         class HTTPGetAction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -383,7 +370,8 @@ module Google
         # @!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 8080.
+        #     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
@@ -393,7 +381,8 @@ module Google
         # @!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 8080.
+        #     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

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

@@ -103,17 +103,20 @@ module Google
         #   @return [::Integer]
         #     Output only. A number that monotonically increases every time the user
         #     modifies the desired state.
-        # @!attribute [rw] labels
+        # @!attribute [r] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style labels for the resource.
-        #     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
+        #     Output only. 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
-        # @!attribute [rw] annotations
+        #     https://cloud.google.com/run/docs/configuring/labels.
+        # @!attribute [r] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style annotations for the resource.
+        #     Output only. 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.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The creation time.
@@ -131,10 +134,14 @@ module Google
         #     request.
         # @!attribute [rw] launch_stage
         #   @return [::Google::Api::LaunchStage]
-        #     Set the launch stage to a preview stage on write to allow use of preview
-        #     features in that stage. On read, describes whether the resource uses
-        #     preview features. Launch Stages are defined at [Google Cloud Platform
-        #     Launch Stages](https://cloud.google.com/terms/launch-stages).
+        #     The least stable launch stage needed to create this resource, as defined by
+        #     [Google Cloud Platform Launch
+        #     Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports
+        #     `ALPHA`, `BETA`, and `GA`.
+        #     <p>Note that this value might not be what was used
+        #     as input. For example, if ALPHA was provided as input in the parent
+        #     resource, but only BETA and GA-level features are were, this field will be
+        #     BETA.
         # @!attribute [r] service
         #   @return [::String]
         #     Output only. The name of the parent service.
@@ -196,6 +203,12 @@ module Google
         # @!attribute [r] log_uri
         #   @return [::String]
         #     Output only. The Google Console URI to obtain logs for the Revision.
+        # @!attribute [r] satisfies_pzs
+        #   @return [::Boolean]
+        #     Output only. Reserved for future use.
+        # @!attribute [rw] session_affinity
+        #   @return [::Boolean]
+        #     Enable session affinity.
         # @!attribute [r] etag
         #   @return [::String]
         #     Output only. A system-generated fingerprint for this version of the

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

@@ -29,7 +29,13 @@ module Google
         #     automatically generated based on the Service name.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style labels for the resource.
+        #     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.
         #
         #     <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -37,12 +43,17 @@ module Google
         #     corresponding field in v2 RevisionTemplate.
         # @!attribute [rw] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style annotations for the resource.
+        #     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`
         #     namespaces, and they will be rejected. All system annotations in v1 now
         #     have a corresponding field in v2 RevisionTemplate.
+        #
+        #     <p>This field follows Kubernetes annotations' namespacing, limits, and
+        #     rules.
         # @!attribute [rw] scaling
         #   @return [::Google::Cloud::Run::V2::RevisionScaling]
         #     Scaling settings for this Revision.
@@ -77,6 +88,9 @@ module Google
         # @!attribute [rw] max_instance_request_concurrency
         #   @return [::Integer]
         #     Sets the maximum number of requests that each serving instance can receive.
+        # @!attribute [rw] session_affinity
+        #   @return [::Boolean]
+        #     Enable session affinity.
         class RevisionTemplate
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -55,8 +55,8 @@ module Google
         # @!attribute [rw] allow_missing
         #   @return [::Boolean]
         #     If set to true, and if the Service 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.
+        #     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
@@ -157,13 +157,13 @@ module Google
         #     APIs, its JSON representation will be a `string` instead of an `integer`.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Map of string keys and values that can be used to organize and categorize
+        #     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
+        #     https://cloud.google.com/run/docs/configuring/labels.
         #
         #     <p>Cloud Run API v2 does not support labels with  `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -177,12 +177,11 @@ module Google
         #
         #     <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
-        #     namespaces, and they will be rejected. All system annotations in v1 now
-        #     have a corresponding field in v2 Service.
+        #     namespaces, and they will be rejected in new resources. All system
+        #     annotations in v1 now have a corresponding field in v2 Service.
         #
         #     <p>This field follows Kubernetes
-        #     annotations' namespacing, limits, and rules. More info:
-        #     https://kubernetes.io/docs/user-guide/annotations
+        #     annotations' namespacing, limits, and rules.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The creation time.
@@ -219,6 +218,12 @@ module Google
         #     Launch Stages](https://cloud.google.com/terms/launch-stages).
         #     Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA
         #     is assumed.
+        #     Set the launch stage to a preview stage on input to allow use of preview
+        #     features in that stage. On read (or output), describes whether the resource
+        #     uses preview features.
+        #     <p>
+        #     For example, if ALPHA is provided as input, but only BETA and GA-level
+        #     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.
@@ -267,6 +272,9 @@ module Google
         # @!attribute [r] uri
         #   @return [::String]
         #     Output only. The main URI in which this Service is serving traffic.
+        # @!attribute [r] satisfies_pzs
+        #   @return [::Boolean]
+        #     Output only. Reserved for future use.
         # @!attribute [r] reconciling
         #   @return [::Boolean]
         #     Output only. Returns true if the Service is currently being acted upon by