job.rb in google-cloud-run-v2-0.6.0

- old
+ new

@@ -142,22 +142,23 @@
         class RunJobRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Job represents the configuration of a single job. A job an immutable resource
-        # that references a container image which is run to completion.
+        # Job represents the configuration of a single job, which references a
+        # container image that is run to completion.
         # @!attribute [rw] name
         #   @return [::String]
         #     The fully qualified name of this Job.
         #
         #     Format:
         #     projects/\\{project}/locations/\\{location}/jobs/\\{job}
         # @!attribute [r] uid
         #   @return [::String]
-        #     Output only. Server assigned unique identifier for the Execution. The value is a UUID4
-        #     string and guaranteed to remain unchanged until the resource is deleted.
+        #     Output only. Server assigned unique identifier for the Execution. The value
+        #     is a UUID4 string and guaranteed to remain unchanged until the resource is
+        #     deleted.
         # @!attribute [r] generation
         #   @return [::Integer]
         #     Output only. A number that monotonically increases every time the user
         #     modifies the desired state.
         # @!attribute [rw] labels
@@ -166,22 +167,29 @@
         #     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
-        #     Cloud Run will populate some labels with 'run.googleapis.com' or
-        #     'serving.knative.dev' namespaces. Those labels are read-only, and user
-        #     changes will not be preserved.
+        #
+        #     <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
+        #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
+        #     namespaces, and they will be rejected. All system labels in v1 now have a
+        #     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
         #     be set by external tools to store and arbitrary metadata.
         #     They are not queryable and should be preserved
-        #     when modifying objects. Cloud Run will populate some annotations using
-        #     'run.googleapis.com' or 'serving.knative.dev' namespaces. This field
-        #     follows Kubernetes annotations' namespacing, limits, and rules. More info:
-        #     https://kubernetes.io/docs/user-guide/annotations
+        #     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.
+        #
+        #     <p>This field follows Kubernetes annotations' namespacing, limits, and
+        #     rules. More info: https://kubernetes.io/docs/user-guide/annotations
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The creation time.
         # @!attribute [r] update_time
         #   @return [::Google::Protobuf::Timestamp]
@@ -217,31 +225,31 @@
         # @!attribute [rw] template
         #   @return [::Google::Cloud::Run::V2::ExecutionTemplate]
         #     Required. The template used to create executions for this Job.
         # @!attribute [r] observed_generation
         #   @return [::Integer]
-        #     Output only. The generation of this Job. See comments in `reconciling` for additional
-        #     information on reconciliation process in Cloud Run.
+        #     Output only. The generation of this Job. See comments in `reconciling` for
+        #     additional information on reconciliation process in Cloud Run.
         # @!attribute [r] terminal_condition
         #   @return [::Google::Cloud::Run::V2::Condition]
-        #     Output only. The Condition of this Job, containing its readiness status, and
-        #     detailed error information in case it did not reach the desired state.
+        #     Output only. The Condition of this Job, containing its readiness status,
+        #     and detailed error information in case it did not reach the desired state.
         # @!attribute [r] conditions
         #   @return [::Array<::Google::Cloud::Run::V2::Condition>]
-        #     Output only. The Conditions of all other associated sub-resources. They contain
-        #     additional diagnostics information in case the Job does not reach its
-        #     desired state. See comments in `reconciling` for additional information on
-        #     reconciliation process in Cloud Run.
+        #     Output only. The Conditions of all other associated sub-resources. They
+        #     contain additional diagnostics information in case the Job does not reach
+        #     its desired state. See comments in `reconciling` for additional information
+        #     on reconciliation process in Cloud Run.
         # @!attribute [r] execution_count
         #   @return [::Integer]
         #     Output only. Number of executions created for this job.
         # @!attribute [r] latest_created_execution
         #   @return [::Google::Cloud::Run::V2::ExecutionReference]
         #     Output only. Name of the last created execution.
         # @!attribute [r] reconciling
         #   @return [::Boolean]
-        #     Output only. Returns true if the Job is currently being acted upon by the system to
-        #     bring it into the desired state.
+        #     Output only. Returns true if the Job is currently being acted upon by the
+        #     system to bring it into the desired state.
         #
         #     When a new Job is created, or an existing one is updated, Cloud Run
         #     will asynchronously perform all necessary steps to bring the Job to the
         #     desired state. This process is called reconciliation.
         #     While reconciliation is in process, `observed_generation` and