google-apis-run_v1 0.35.0 → 0.38.0

data/lib/google/apis/run_v1/classes.rb

@@ -167,31 +167,33 @@ module Google
         # members` can have the following values: * `allUsers`: A special identifier
         # that represents anyone who is on the internet; with or without a Google
         # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # anyone who is authenticated with a Google account or a service account. * `
-        # user:`emailid``: An email address that represents a specific Google account.
-        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # address that represents a Google service account. For example, `my-other-app@
-        # appspot.gserviceaccount.com`. * `serviceAccount:`projectid`.svc.id.goog[`
-        # namespace`/`kubernetes-sa`]`: An identifier for a [Kubernetes service account](
-        # https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-
-        # accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`
-        # . * `group:`emailid``: An email address that represents a Google group. For
-        # example, `admins@example.com`. * `deleted:user:`emailid`?uid=`uniqueid``: An
-        # email address (plus unique identifier) representing a user that has been
-        # recently deleted. For example, `alice@example.com?uid=123456789012345678901`.
-        # If the user is recovered, this value reverts to `user:`emailid`` and the
-        # recovered user retains the role in the binding. * `deleted:serviceAccount:`
-        # emailid`?uid=`uniqueid``: An email address (plus unique identifier)
-        # representing a service account that has been recently deleted. For example, `
-        # my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the
-        # service account is undeleted, this value reverts to `serviceAccount:`emailid``
-        # and the undeleted service account retains the role in the binding. * `deleted:
-        # group:`emailid`?uid=`uniqueid``: An email address (plus unique identifier)
-        # representing a Google group that has been recently deleted. For example, `
-        # admins@example.com?uid=123456789012345678901`. If the group is recovered, this
-        # value reverts to `group:`emailid`` and the recovered group retains the role in
-        # the binding. * `domain:`domain``: The G Suite domain (primary) that represents
-        # all the users of that domain. For example, `google.com` or `example.com`.
+        # anyone who is authenticated with a Google account or a service account. Does
+        # not include identities that come from external identity providers (IdPs)
+        # through identity federation. * `user:`emailid``: An email address that
+        # represents a specific Google account. For example, `alice@example.com` . * `
+        # serviceAccount:`emailid``: An email address that represents a Google service
+        # account. For example, `my-other-app@appspot.gserviceaccount.com`. * `
+        # serviceAccount:`projectid`.svc.id.goog[`namespace`/`kubernetes-sa`]`: An
+        # identifier for a [Kubernetes service account](https://cloud.google.com/
+        # kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-
+        # project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:`emailid``: An
+        # email address that represents a Google group. For example, `admins@example.com`
+        # . * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a user that has been recently deleted. For example, `
+        # alice@example.com?uid=123456789012345678901`. If the user is recovered, this
+        # value reverts to `user:`emailid`` and the recovered user retains the role in
+        # the binding. * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email
+        # address (plus unique identifier) representing a service account that has been
+        # recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=
+        # 123456789012345678901`. If the service account is undeleted, this value
+        # reverts to `serviceAccount:`emailid`` and the undeleted service account
+        # retains the role in the binding. * `deleted:group:`emailid`?uid=`uniqueid``:
+        # An email address (plus unique identifier) representing a Google group that has
+        # been recently deleted. For example, `admins@example.com?uid=
+        # 123456789012345678901`. If the group is recovered, this value reverts to `
+        # group:`emailid`` and the recovered group retains the role in the binding. * `
+        # domain:`domain``: The G Suite domain (primary) that represents all the users
+        # of that domain. For example, `google.com` or `example.com`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
         attr_accessor :members
@@ -227,14 +229,14 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run ConfigMapEnvSource selects a ConfigMap to populate
+      # Not supported by Cloud Run. ConfigMapEnvSource selects a ConfigMap to populate
       # the environment variables with. The contents of the target ConfigMap's Data
       # field will represent the key-value pairs as environment variables.
       class ConfigMapEnvSource
         include Google::Apis::Core::Hashable
       
-        # Not supported by Cloud Run LocalObjectReference contains enough information to
-        # let you locate the referenced object inside the same namespace.
+        # Not supported by Cloud Run. LocalObjectReference contains enough information
+        # to let you locate the referenced object inside the same namespace.
         # Corresponds to the JSON property `localObjectReference`
         # @return [Google::Apis::RunV1::LocalObjectReference]
         attr_accessor :local_object_reference
@@ -244,7 +246,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # (Optional) Specify whether the ConfigMap must be defined
+        # Specify whether the ConfigMap must be defined.
         # Corresponds to the JSON property `optional`
         # @return [Boolean]
         attr_accessor :optional
@@ -262,27 +264,27 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run Selects a key from a ConfigMap.
+      # Not supported by Cloud Run.
       class ConfigMapKeySelector
         include Google::Apis::Core::Hashable
       
-        # The key to select.
+        # Required. Not supported by Cloud Run.
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
       
-        # Not supported by Cloud Run LocalObjectReference contains enough information to
-        # let you locate the referenced object inside the same namespace.
+        # Not supported by Cloud Run. LocalObjectReference contains enough information
+        # to let you locate the referenced object inside the same namespace.
         # Corresponds to the JSON property `localObjectReference`
         # @return [Google::Apis::RunV1::LocalObjectReference]
         attr_accessor :local_object_reference
       
-        # The ConfigMap to select from.
+        # Required. Not supported by Cloud Run.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # (Optional) Specify whether the ConfigMap or its key must be defined
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `optional`
         # @return [Boolean]
         attr_accessor :optional
@@ -301,7 +303,7 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run Adapts a ConfigMap into a volume. The contents of
+      # Not supported by Cloud Run. Adapts a ConfigMap into a volume. The contents of
       # the target ConfigMap's Data field will be presented in a volume as files using
       # the keys in the Data field as the file names, unless the items element is
       # populated with specific mappings of keys to paths.
@@ -361,7 +363,7 @@ module Google
       # and optionally how the containers those revisions reference are built. Users
       # create new Revisions by updating the Configuration's spec. The "latest created"
       # revision's name is available under status, as is the "latest ready" revision'
-      # s name. See also: https://github.com/knative/serving/blob/main/docs/spec/
+      # s name. See also: https://github.com/knative/specs/blob/main/specs/serving/
       # overview.md#configuration
       class Configuration
         include Google::Apis::Core::Hashable
@@ -435,14 +437,15 @@ module Google
       class ConfigurationStatus
         include Google::Apis::Core::Hashable
       
-        # Conditions communicates information about ongoing/complete reconciliation
+        # Conditions communicate information about ongoing/complete reconciliation
         # processes that bring the "spec" inline with the observed state of the world.
         # Corresponds to the JSON property `conditions`
         # @return [Array<Google::Apis::RunV1::GoogleCloudRunV1Condition>]
         attr_accessor :conditions
       
         # LatestCreatedRevisionName is the last revision that was created from this
-        # Configuration. It might not be ready yet, for that use LatestReadyRevisionName.
+        # Configuration. It might not be ready yet, so for the latest ready revision,
+        # use LatestReadyRevisionName.
         # Corresponds to the JSON property `latestCreatedRevisionName`
         # @return [String]
         attr_accessor :latest_created_revision_name
@@ -481,68 +484,58 @@ module Google
       class Container
         include Google::Apis::Core::Hashable
       
-        # (Optional) 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
+        # Arguments to the entrypoint. The docker image's CMD is used if this is not
+        # provided. Variable references are not supported in Cloud Run.
         # Corresponds to the JSON property `args`
         # @return [Array<String>]
         attr_accessor :args
       
-        # 
+        # Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT
+        # is used if this is not provided. Variable references are not supported in
+        # Cloud Run.
         # Corresponds to the JSON property `command`
         # @return [Array<String>]
         attr_accessor :command
       
-        # (Optional) List of environment variables to set in the container.
+        # List of environment variables to set in the container.
         # Corresponds to the JSON property `env`
         # @return [Array<Google::Apis::RunV1::EnvVar>]
         attr_accessor :env
       
-        # (Optional) List of sources to populate environment variables in the container.
-        # The keys defined within a source must be a C_IDENTIFIER. All invalid keys will
-        # be reported as an event when the container is starting. When a key exists in
-        # multiple sources, the value associated with the last source will take
-        # precedence. Values defined by an Env with a duplicate key will take precedence.
-        # Cannot be updated.
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `envFrom`
         # @return [Array<Google::Apis::RunV1::EnvFromSource>]
         attr_accessor :env_from
       
-        # Only supports containers from Google Container Registry or Artifact Registry
-        # URL of the Container image. More info: https://kubernetes.io/docs/concepts/
-        # containers/images
+        # Required. URL of the Container image in Google Container Registry or Google
+        # Artifact Registry. More info: https://kubernetes.io/docs/concepts/containers/
+        # images
         # Corresponds to the JSON property `image`
         # @return [String]
         attr_accessor :image
       
-        # (Optional) Image pull policy. One of Always, Never, IfNotPresent. Defaults to
-        # Always if :latest tag is specified, or IfNotPresent otherwise. More info:
-        # https://kubernetes.io/docs/concepts/containers/images#updating-images
+        # Image pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :
+        # latest tag is specified, or IfNotPresent otherwise. More info: https://
+        # kubernetes.io/docs/concepts/containers/images#updating-images
         # Corresponds to the JSON property `imagePullPolicy`
         # @return [String]
         attr_accessor :image_pull_policy
       
-        # Not supported by Cloud Run Probe describes a health check to be performed
-        # against a container to determine whether it is alive or ready to receive
-        # traffic.
+        # Probe describes a health check to be performed against a container to
+        # determine whether it is alive or ready to receive traffic.
         # Corresponds to the JSON property `livenessProbe`
         # @return [Google::Apis::RunV1::Probe]
         attr_accessor :liveness_probe
       
-        # (Optional) Name of the container specified as a DNS_LABEL. Currently unused in
-        # Cloud Run. More info: https://kubernetes.io/docs/concepts/overview/working-
-        # with-objects/names/#dns-label-names
+        # Name of the container specified as a DNS_LABEL. Currently unused in Cloud Run.
+        # More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/
+        # names/#dns-label-names
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # (Optional) List of ports to expose from the container. Only a single port can
-        # be specified. The specified ports must be listening on all interfaces (0.0.0.0)
+        # List of ports to expose from the container. Only a single port can be
+        # specified. The specified ports must be listening on all interfaces (0.0.0.0)
         # within the container to be accessible. If omitted, a port number will be
         # chosen and passed to the container through the PORT environment variable for
         # the container to listen on.
@@ -550,9 +543,8 @@ module Google
         # @return [Array<Google::Apis::RunV1::ContainerPort>]
         attr_accessor :ports
       
-        # Not supported by Cloud Run Probe describes a health check to be performed
-        # against a container to determine whether it is alive or ready to receive
-        # traffic.
+        # Probe describes a health check to be performed against a container to
+        # determine whether it is alive or ready to receive traffic.
         # Corresponds to the JSON property `readinessProbe`
         # @return [Google::Apis::RunV1::Probe]
         attr_accessor :readiness_probe
@@ -562,7 +554,7 @@ module Google
         # @return [Google::Apis::RunV1::ResourceRequirements]
         attr_accessor :resources
       
-        # Not supported by Cloud Run SecurityContext holds security configuration that
+        # Not supported by Cloud Run. SecurityContext holds security configuration that
         # will be applied to a container. Some fields are present in both
         # SecurityContext and PodSecurityContext. When both are set, the values in
         # SecurityContext take precedence.
@@ -570,15 +562,14 @@ module Google
         # @return [Google::Apis::RunV1::SecurityContext]
         attr_accessor :security_context
       
-        # Not supported by Cloud Run Probe describes a health check to be performed
-        # against a container to determine whether it is alive or ready to receive
-        # traffic.
+        # Probe describes a health check to be performed against a container to
+        # determine whether it is alive or ready to receive traffic.
         # Corresponds to the JSON property `startupProbe`
         # @return [Google::Apis::RunV1::Probe]
         attr_accessor :startup_probe
       
-        # (Optional) Path at which the file to which the container's termination message
-        # will be written is mounted into the container's filesystem. Message written is
+        # Path at which the file to which the container's termination message will be
+        # written is mounted into the container's filesystem. Message written is
         # intended to be brief final status, such as an assertion failure message. Will
         # be truncated by the node if greater than 4096 bytes. The total message length
         # across all containers will be limited to 12kb. Defaults to /dev/termination-
@@ -587,25 +578,24 @@ module Google
         # @return [String]
         attr_accessor :termination_message_path
       
-        # (Optional) Indicate how the termination message should be populated. File will
-        # use the contents of terminationMessagePath to populate the container status
-        # message on both success and failure. FallbackToLogsOnError will use the last
-        # chunk of container log output if the termination message file is empty and the
+        # Indicate how the termination message should be populated. File will use the
+        # contents of terminationMessagePath to populate the container status message on
+        # both success and failure. FallbackToLogsOnError will use the last chunk of
+        # container log output if the termination message file is empty and the
         # container exited with an error. The log output is limited to 2048 bytes or 80
         # lines, whichever is smaller. Defaults to File. Cannot be updated.
         # Corresponds to the JSON property `terminationMessagePolicy`
         # @return [String]
         attr_accessor :termination_message_policy
       
-        # (Optional) Volume to mount into the container's filesystem. Only supports
+        # Volume to mount into the container's filesystem. Only supports
         # SecretVolumeSources. Pod volumes to mount into the container's filesystem.
         # Corresponds to the JSON property `volumeMounts`
         # @return [Array<Google::Apis::RunV1::VolumeMount>]
         attr_accessor :volume_mounts
       
-        # (Optional) Container's working directory. If not specified, the container
-        # runtime's default will be used, which might be configured in the container
-        # image.
+        # Container's working directory. If not specified, the container runtime's
+        # default will be used, which might be configured in the container image.
         # Corresponds to the JSON property `workingDir`
         # @return [String]
         attr_accessor :working_dir
@@ -640,19 +630,19 @@ module Google
       class ContainerPort
         include Google::Apis::Core::Hashable
       
-        # (Optional) Port number the container listens on. This must be a valid port
-        # number, 0 < x < 65536.
+        # Port number the container listens on. This must be a valid port number, 0 < x <
+        # 65536.
         # Corresponds to the JSON property `containerPort`
         # @return [Fixnum]
         attr_accessor :container_port
       
-        # (Optional) If specified, used to specify which protocol to use. Allowed values
-        # are "http1" and "h2c".
+        # If specified, used to specify which protocol to use. Allowed values are "http1"
+        # and "h2c".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # (Optional) Protocol for port. Must be "TCP". Defaults to "TCP".
+        # Protocol for port. Must be "TCP". Defaults to "TCP".
         # Corresponds to the JSON property `protocol`
         # @return [String]
         attr_accessor :protocol
@@ -780,8 +770,7 @@ module Google
         # @return [Array<Google::Apis::RunV1::ResourceRecord>]
         attr_accessor :resource_records
       
-        # Optional. Cloud Run fully managed: not supported Cloud Run on GKE: supported
-        # Holds the URL that will serve the traffic of the DomainMapping.
+        # Optional. Not supported by Cloud Run.
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -800,25 +789,25 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run EnvFromSource represents the source of a set of
+      # Not supported by Cloud Run. EnvFromSource represents the source of a set of
       # ConfigMaps
       class EnvFromSource
         include Google::Apis::Core::Hashable
       
-        # Not supported by Cloud Run ConfigMapEnvSource selects a ConfigMap to populate
+        # Not supported by Cloud Run. ConfigMapEnvSource selects a ConfigMap to populate
         # the environment variables with. The contents of the target ConfigMap's Data
         # field will represent the key-value pairs as environment variables.
         # Corresponds to the JSON property `configMapRef`
         # @return [Google::Apis::RunV1::ConfigMapEnvSource]
         attr_accessor :config_map_ref
       
-        # (Optional) An optional identifier to prepend to each key in the ConfigMap.
-        # Must be a C_IDENTIFIER.
+        # An optional identifier to prepend to each key in the ConfigMap. Must be a
+        # C_IDENTIFIER.
         # Corresponds to the JSON property `prefix`
         # @return [String]
         attr_accessor :prefix
       
-        # Not supported by Cloud Run SecretEnvSource selects a Secret to populate the
+        # Not supported by Cloud Run. SecretEnvSource selects a Secret to populate the
         # environment variables with. The contents of the target Secret's Data field
         # will represent the key-value pairs as environment variables.
         # Corresponds to the JSON property `secretRef`
@@ -841,17 +830,13 @@ module Google
       class EnvVar
         include Google::Apis::Core::Hashable
       
-        # Name of the environment variable. Must be a C_IDENTIFIER.
+        # Required. Name of the environment variable. Must be a C_IDENTIFIER.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # (Optional) Variable references $(VAR_NAME) are expanded using the previous
-        # defined environment variables in the container and any route environment
-        # variables. 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. Defaults to "".
+        # Value of the environment variable. Defaults to "". Variable references are not
+        # supported in Cloud Run.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -877,7 +862,7 @@ module Google
       class EnvVarSource
         include Google::Apis::Core::Hashable
       
-        # Not supported by Cloud Run Selects a key from a ConfigMap.
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `configMapKeyRef`
         # @return [Google::Apis::RunV1::ConfigMapKeySelector]
         attr_accessor :config_map_key_ref
@@ -898,16 +883,16 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run ExecAction describes a "run in container" action.
+      # Not supported by Cloud Run. ExecAction describes a "run in container" action.
       class ExecAction
         include Google::Apis::Core::Hashable
       
-        # (Optional) Command is the command line to execute inside the container, the
-        # working directory for the command is root ('/') in the container's filesystem.
-        # The command is simply exec'd, it is not run inside a shell, so traditional
-        # shell instructions ('|', etc) won't work. To use a shell, you need to
-        # explicitly call out to that shell. Exit status of 0 is treated as live/healthy
-        # and non-zero is unhealthy.
+        # Command is the command line to execute inside the container, the working
+        # directory for the command is root ('/') in the container's filesystem. The
+        # command is simply exec'd, it is not run inside a shell, so traditional shell
+        # instructions ('|', etc) won't work. To use a shell, you need to explicitly
+        # call out to that shell. Exit status of 0 is treated as live/healthy and non-
+        # zero is unhealthy.
         # Corresponds to the JSON property `command`
         # @return [Array<String>]
         attr_accessor :command
@@ -922,8 +907,8 @@ module Google
         end
       end
       
-      # Execution represents the configuration of a single execution. A execution an
-      # immutable resource that references a container image which is run to
+      # Execution represents the configuration of a single execution. An execution is
+      # an immutable resource that references a container image which is run to
       # completion.
       class Execution
         include Google::Apis::Core::Hashable
@@ -931,7 +916,7 @@ module Google
         # Optional. APIVersion defines the versioned schema of this representation of an
         # object. Servers should convert recognized schemas to the latest internal value,
         # and may reject unrecognized values. More info: https://git.k8s.io/community/
-        # contributors/devel/sig-architecture/api-conventions.md#resources +optional
+        # contributors/devel/sig-architecture/api-conventions.md#resources
         # Corresponds to the JSON property `apiVersion`
         # @return [String]
         attr_accessor :api_version
@@ -939,8 +924,7 @@ module Google
         # Optional. Kind is a string value representing the REST resource this object
         # represents. Servers may infer this from the endpoint the client submits
         # requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/
-        # community/contributors/devel/sig-architecture/api-conventions.md#types-kinds +
-        # optional
+        # community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -956,7 +940,7 @@ module Google
         # @return [Google::Apis::RunV1::ExecutionSpec]
         attr_accessor :spec
       
-        # ExecutionStatus represents the current state of a Execution.
+        # ExecutionStatus represents the current state of an Execution.
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::RunV1::ExecutionStatus]
         attr_accessor :status
@@ -1015,16 +999,15 @@ module Google
         # run at given time. Must be <= task_count. When the job is run, if this field
         # is 0 or unset, the maximum possible value will be used for that execution. The
         # actual number of tasks running in steady state will be less than this number
-        # when there are fewer tasks waiting to be completed remaining, i.e. when the
-        # work left to do is less than max parallelism. +optional
+        # when there are fewer tasks waiting to be completed, i.e. when the work left to
+        # do is less than max parallelism.
         # Corresponds to the JSON property `parallelism`
         # @return [Fixnum]
         attr_accessor :parallelism
       
         # Optional. 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/ +optional
+        # task signals the success of the execution.
         # Corresponds to the JSON property `taskCount`
         # @return [Fixnum]
         attr_accessor :task_count
@@ -1047,30 +1030,33 @@ module Google
         end
       end
       
-      # ExecutionStatus represents the current state of a Execution.
+      # ExecutionStatus represents the current state of an Execution.
       class ExecutionStatus
         include Google::Apis::Core::Hashable
       
-        # Optional. The number of tasks which reached phase Cancelled. +optional
+        # Optional. The number of tasks which reached phase Cancelled.
         # Corresponds to the JSON property `cancelledCount`
         # @return [Fixnum]
         attr_accessor :cancelled_count
       
-        # Optional. Represents time when the execution was completed. It is not
+        # Optional. Represents the time that the execution was completed. It is not
         # guaranteed to be set in happens-before order across separate operations. It is
         # represented in RFC3339 form and is in UTC. +optional
         # Corresponds to the JSON property `completionTime`
         # @return [String]
         attr_accessor :completion_time
       
-        # Optional. The latest available observations of an execution's current state.
-        # More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-
-        # to-completion/ +optional
+        # Optional. Conditions communicate information about ongoing/complete
+        # reconciliation processes that bring the "spec" inline with the observed state
+        # of the world. Execution-specific conditions include: * `ResourcesAvailable`: `
+        # True` when underlying resources have been provisioned. * `Started`: `True`
+        # when the execution has started to execute. * `Completed`: `True` when the
+        # execution has succeeded. `False` when the execution has failed.
         # Corresponds to the JSON property `conditions`
         # @return [Array<Google::Apis::RunV1::GoogleCloudRunV1Condition>]
         attr_accessor :conditions
       
-        # Optional. The number of tasks which reached phase Failed. +optional
+        # Optional. The number of tasks which reached phase Failed.
         # Corresponds to the JSON property `failedCount`
         # @return [Fixnum]
         attr_accessor :failed_count
@@ -1086,24 +1072,24 @@ module Google
         # @return [Fixnum]
         attr_accessor :observed_generation
       
-        # Optional. The number of tasks which have retried at least once. +optional
+        # Optional. The number of tasks which have retried at least once.
         # Corresponds to the JSON property `retriedCount`
         # @return [Fixnum]
         attr_accessor :retried_count
       
-        # Optional. The number of actively running tasks. +optional
+        # Optional. The number of actively running tasks.
         # Corresponds to the JSON property `runningCount`
         # @return [Fixnum]
         attr_accessor :running_count
       
-        # Optional. Represents time when the execution started to run. It is not
+        # Optional. Represents the time that the execution started to run. It is not
         # guaranteed to be set in happens-before order across separate operations. It is
-        # represented in RFC3339 form and is in UTC. +optional
+        # represented in RFC3339 form and is in UTC.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # Optional. The number of tasks which reached phase Succeeded. +optional
+        # Optional. The number of tasks which reached phase Succeeded.
         # Corresponds to the JSON property `succeededCount`
         # @return [Fixnum]
         attr_accessor :succeeded_count
@@ -1236,7 +1222,12 @@ module Google
         end
       end
       
-      # Condition defines a generic condition for a Resource.
+      # Conditions show the status of reconciliation progress on a given resource.
+      # Most resource use a top-level condition type "Ready" or "Completed" to show
+      # overall status with other conditions to checkpoint each stage of
+      # reconciliation. Note that if metadata.Generation does not equal status.
+      # ObservedGeneration, the conditions shown may not be relevant for the current
+      # spec.
       class GoogleCloudRunV1Condition
         include Google::Apis::Core::Hashable
       
@@ -1250,13 +1241,16 @@ module Google
         # @return [String]
         attr_accessor :message
       
-        # Optional. One-word CamelCase reason for the condition's last transition.
+        # Optional. One-word CamelCase reason for the condition's last transition. These
+        # are intended to be stable, unique values which the client may use to trigger
+        # error handling logic, whereas messages which may be changed later by the
+        # server.
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
       
-        # Optional. How to interpret failures of this condition, one of Error, Warning,
-        # Info
+        # Optional. How to interpret this condition. One of Error, Warning, or Info.
+        # Conditions of severity Info do not contribute to resource readiness.
         # Corresponds to the JSON property `severity`
         # @return [String]
         attr_accessor :severity
@@ -1268,8 +1262,8 @@ module Google
       
         # type is used to communicate the status of the reconciliation process. See also:
         # https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-
-        # conditions-and-reporting Types common to all resources include: * "Ready":
-        # True when the Resource is ready.
+        # conditions-and-reporting Types common to all resources include: * "Ready" or "
+        # Completed": True when the Resource is ready.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1332,23 +1326,22 @@ module Google
       class HttpGetAction
         include Google::Apis::Core::Hashable
       
-        # (Optional) Host name to connect to, defaults to the pod IP. You probably want
-        # to set "Host" in httpHeaders instead.
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `host`
         # @return [String]
         attr_accessor :host
       
-        # (Optional) Custom headers to set in the request. HTTP allows repeated headers.
+        # Custom headers to set in the request. HTTP allows repeated headers.
         # Corresponds to the JSON property `httpHeaders`
         # @return [Array<Google::Apis::RunV1::HttpHeader>]
         attr_accessor :http_headers
       
-        # (Optional) Path to access on the HTTP server.
+        # Path to access on the HTTP server.
         # Corresponds to the JSON property `path`
         # @return [String]
         attr_accessor :path
       
-        # (Optional) Scheme to use for connecting to the host. Defaults to HTTP.
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `scheme`
         # @return [String]
         attr_accessor :scheme
@@ -1391,15 +1384,15 @@ module Google
         end
       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 which is run to completion.
       class Job
         include Google::Apis::Core::Hashable
       
         # Optional. APIVersion defines the versioned schema of this representation of an
         # object. Servers should convert recognized schemas to the latest internal value,
         # and may reject unrecognized values. More info: https://git.k8s.io/community/
-        # contributors/devel/sig-architecture/api-conventions.md#resources +optional
+        # contributors/devel/sig-architecture/api-conventions.md#resources
         # Corresponds to the JSON property `apiVersion`
         # @return [String]
         attr_accessor :api_version
@@ -1407,8 +1400,7 @@ module Google
         # Optional. Kind is a string value representing the REST resource this object
         # represents. Servers may infer this from the endpoint the client submits
         # requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/
-        # community/contributors/devel/sig-architecture/api-conventions.md#types-kinds +
-        # optional
+        # community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1468,8 +1460,10 @@ module Google
       class JobStatus
         include Google::Apis::Core::Hashable
       
-        # The latest available observations of a job's current state. More info: https://
-        # kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+        # Conditions communicate information about ongoing/complete reconciliation
+        # processes that bring the "spec" inline with the observed state of the world.
+        # Job-specific conditions include: * `Ready`: `True` when the job is ready to be
+        # executed.
         # Corresponds to the JSON property `conditions`
         # @return [Array<Google::Apis::RunV1::GoogleCloudRunV1Condition>]
         attr_accessor :conditions
@@ -1589,9 +1583,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
@@ -1634,9 +1627,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
@@ -1679,9 +1671,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
@@ -1724,9 +1715,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
@@ -1775,35 +1765,28 @@ module Google
         end
       end
       
-      # ListMeta describes metadata that synthetic resources must have, including
-      # lists and various status objects. A resource may have only one of `ObjectMeta,
-      # ListMeta`.
+      # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+      # Responses will have a ListMeta instead of ObjectMeta.
       class ListMeta
         include Google::Apis::Core::Hashable
       
-        # continue may be set if the user set a limit on the number of items returned,
-        # and indicates that the server has more data available. The value is opaque and
-        # may be used to issue another request to the endpoint that served this list to
-        # retrieve the next set of available objects. Continuing a list may not be
-        # possible if the server configuration has changed or more than a few minutes
-        # have passed. The resourceVersion field returned when using this continue value
-        # will be identical to the value in the first response.
+        # Continuation token is a value emitted when the count of items is larger than
+        # the user/system limit. To retrieve the next page of items, pass the value of `
+        # continue` as the next request's `page_token`.
         # Corresponds to the JSON property `continue`
         # @return [String]
         attr_accessor :continue
       
-        # String that identifies the server's internal version of this object that can
-        # be used by clients to determine when objects have changed. Value must be
-        # treated as opaque by clients and passed unmodified back to the server.
-        # Populated by the system. Read-only. More info: https://git.k8s.io/community/
-        # contributors/devel/api-conventions.md#concurrency-control-and-consistency +
-        # optional
+        # Opaque string that identifies the server's internal version of this object. It
+        # can be used by clients to determine when objects have changed. If the message
+        # is passed back to the server, it must be left unmodified. https://git.k8s.io/
+        # community/contributors/devel/api-conventions.md#concurrency-control-and-
+        # consistency
         # Corresponds to the JSON property `resourceVersion`
         # @return [String]
         attr_accessor :resource_version
       
-        # SelfLink is a URL representing this object. Populated by the system. Read-only.
-        # +optional
+        # URL representing this object.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
         attr_accessor :self_link
@@ -1839,9 +1822,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
@@ -1884,9 +1866,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
@@ -1914,7 +1895,7 @@ module Google
       class ListServicesResponse
         include Google::Apis::Core::Hashable
       
-        # The API version for this call such as "serving.knative.dev/v1".
+        # The API version for this call; returns "serving.knative.dev/v1".
         # Corresponds to the JSON property `apiVersion`
         # @return [String]
         attr_accessor :api_version
@@ -1924,19 +1905,19 @@ module Google
         # @return [Array<Google::Apis::RunV1::Service>]
         attr_accessor :items
       
-        # The kind of this resource, in this case "ServiceList".
+        # The kind of this resource; returns "ServiceList".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
       
-        # Locations that could not be reached.
+        # For calls against the global endpoint, returns the list of Cloud locations
+        # that could not be reached. For regional calls, this field is not used.
         # Corresponds to the JSON property `unreachable`
         # @return [Array<String>]
         attr_accessor :unreachable
@@ -1974,9 +1955,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
@@ -2000,13 +1980,13 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run LocalObjectReference contains enough information to
-      # let you locate the referenced object inside the same namespace.
+      # Not supported by Cloud Run. LocalObjectReference contains enough information
+      # to let you locate the referenced object inside the same namespace.
       class LocalObjectReference
         include Google::Apis::Core::Hashable
       
-        # (Optional) Name of the referent. More info: https://kubernetes.io/docs/
-        # concepts/overview/working-with-objects/names/#names
+        # Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/
+        # working-with-objects/names/#names
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2073,150 +2053,118 @@ module Google
       class ObjectMeta
         include Google::Apis::Core::Hashable
       
-        # (Optional) Annotations is an unstructured key value map stored with a resource
-        # that may be set by external tools to store and retrieve arbitrary metadata.
-        # They are not queryable and should be preserved when modifying objects. More
-        # info: https://kubernetes.io/docs/user-guide/annotations
+        # Unstructured key value map stored with a resource that may be set by external
+        # tools to store and retrieve arbitrary metadata. They are not queryable and
+        # should be preserved when modifying objects. In Cloud Run, annotations with '
+        # run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the
+        # accepted annotations will be different depending on the resource type. * `
+        # autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/
+        # minScale`: Revision. * `run.googleapis.com/binary-authorization-breakglass`:
+        # Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job,
+        # Execution. * `run.googleapis.com/client-name`: All resources. * `run.
+        # googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/
+        # cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. *
+        # `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-
+        # key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision,
+        # Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. *
+        # `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/ingress`:
+        # Service. * `run.googleapis.com/network-interfaces`: Revision, Execution. * `
+        # run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.
+        # googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-
+        # session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `
+        # run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-
+        # access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-
+        # egress`: Revision, Execution. Execution. More info: https://kubernetes.io/docs/
+        # user-guide/annotations
         # Corresponds to the JSON property `annotations`
         # @return [Hash<String,String>]
         attr_accessor :annotations
       
-        # (Optional) Not supported by Cloud Run The name of the cluster which the object
-        # belongs to. This is used to distinguish resources with same name and namespace
-        # in different clusters. This field is not set anywhere right now and apiserver
-        # is going to ignore it if set in create or update request.
+        # Not supported by Cloud Run
         # Corresponds to the JSON property `clusterName`
         # @return [String]
         attr_accessor :cluster_name
       
-        # (Optional) CreationTimestamp is a timestamp representing the server time when
-        # this object was created. It is not guaranteed to be set in happens-before
-        # order across separate operations. Clients may not set this value. It is
-        # represented in RFC3339 form and is in UTC. Populated by the system. Read-only.
-        # Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-
-        # conventions.md#metadata
+        # UTC timestamp representing the server time when this object was created. More
+        # info: https://git.k8s.io/community/contributors/devel/api-conventions.md#
+        # metadata
         # Corresponds to the JSON property `creationTimestamp`
         # @return [String]
         attr_accessor :creation_timestamp
       
-        # (Optional) Not supported by Cloud Run Number of seconds allowed for this
-        # object to gracefully terminate before it will be removed from the system. Only
-        # set when deletionTimestamp is also set. May only be shortened. Read-only.
+        # Not supported by Cloud Run
         # Corresponds to the JSON property `deletionGracePeriodSeconds`
         # @return [Fixnum]
         attr_accessor :deletion_grace_period_seconds
       
-        # (Optional) Not supported by Cloud Run DeletionTimestamp is RFC 3339 date and
-        # time at which this resource will be deleted. This field is set by the server
-        # when a graceful deletion is requested by the user, and is not directly
-        # settable by a client. The resource is expected to be deleted (no longer
-        # visible from resource lists, and not reachable by name) after the time in this
-        # field, once the finalizers list is empty. As long as the finalizers list
-        # contains items, deletion is blocked. Once the deletionTimestamp is set, this
-        # value may not be unset or be set further into the future, although it may be
-        # shortened or the resource may be deleted prior to this time. For example, a
-        # user may request that a pod is deleted in 30 seconds. The Kubelet will react
-        # by sending a graceful termination signal to the containers in the pod. After
-        # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) to
-        # the container and after cleanup, remove the pod from the API. In the presence
-        # of network partitions, this object may still exist after this timestamp, until
-        # an administrator or automated process can determine the resource is fully
-        # terminated. If not set, graceful deletion of the object has not been requested.
-        # Populated by the system when a graceful deletion is requested. Read-only.
-        # More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#
-        # metadata
+        # The read-only soft deletion timestamp for this resource. In Cloud Run, users
+        # are not able to set this field. Instead, they must call the corresponding
+        # Delete API.
         # Corresponds to the JSON property `deletionTimestamp`
         # @return [String]
         attr_accessor :deletion_timestamp
       
-        # (Optional) Not supported by Cloud Run Must be empty before the object is
-        # deleted from the registry. Each entry is an identifier for the responsible
-        # component that will remove the entry from the list. If the deletionTimestamp
-        # of the object is non-nil, entries in this list can only be removed. +
-        # patchStrategy=merge
+        # Not supported by Cloud Run
         # Corresponds to the JSON property `finalizers`
         # @return [Array<String>]
         attr_accessor :finalizers
       
-        # (Optional) Not supported by Cloud Run GenerateName is an optional prefix, used
-        # by the server, to generate a unique name ONLY IF the Name field has not been
-        # provided. If this field is used, the name returned to the client will be
-        # different than the name passed. This value will also be combined with a unique
-        # suffix. The provided value has the same validation rules as the Name field,
-        # and may be truncated by the length of the suffix required to make the value
-        # unique on the server. If this field is specified and the generated name exists,
-        # the server will NOT return a 409 - instead, it will either return 201 Created
-        # or 500 with Reason ServerTimeout indicating a unique name could not be found
-        # in the time allotted, and the client should retry (optionally after the time
-        # indicated in the Retry-After header). Applied only if Name is not specified.
-        # More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#
-        # idempotency string generateName = 2;
+        # Not supported by Cloud Run
         # Corresponds to the JSON property `generateName`
         # @return [String]
         attr_accessor :generate_name
       
-        # (Optional) A sequence number representing a specific generation of the desired
-        # state. Populated by the system. Read-only.
+        # A system-provided sequence number representing a specific generation of the
+        # desired state.
         # Corresponds to the JSON property `generation`
         # @return [Fixnum]
         attr_accessor :generation
       
-        # (Optional) Map of string keys and values that can be used to organize and
-        # categorize (scope and select) objects. May match selectors of replication
-        # controllers and routes. More info: https://kubernetes.io/docs/user-guide/
-        # labels
+        # Map of string keys and values that can be used to organize and categorize (
+        # scope and select) objects. May match selectors of replication controllers and
+        # routes. More info: https://kubernetes.io/docs/user-guide/labels
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Name must be unique within a namespace, within a Cloud Run region. Is required
-        # when creating resources, although some resources may allow a client to request
-        # the generation of an appropriate name automatically. Name is primarily
-        # intended for creation idempotence and configuration definition. Cannot be
-        # updated. More info: https://kubernetes.io/docs/user-guide/identifiers#names If
-        # ObjectMeta is part of a namespaces.services.create request, name must contain
-        # fewer than 50 characters. +optional
+        # Required. The name of the resource. In Cloud Run, name is required when
+        # creating top-level resources (Service, Job), must be unique within a Cloud Run
+        # project/region, and cannot be changed once created. More info: https://
+        # kubernetes.io/docs/user-guide/identifiers#names If ObjectMeta is part of a
+        # CreateServiceRequest, name must contain fewer than 50 characters.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Namespace defines the space within each name must be unique, within a Cloud
-        # Run region. In Cloud Run the namespace must be equal to either the project ID
-        # or project number.
+        # Required. Defines the space within each name must be unique within a Cloud Run
+        # region. In Cloud Run, it must be project ID or number.
         # Corresponds to the JSON property `namespace`
         # @return [String]
         attr_accessor :namespace
       
-        # (Optional) Not supported by Cloud Run List of objects that own this object. If
-        # ALL objects in the list have been deleted, this object will be garbage
-        # collected.
+        # Not supported by Cloud Run
         # Corresponds to the JSON property `ownerReferences`
         # @return [Array<Google::Apis::RunV1::OwnerReference>]
         attr_accessor :owner_references
       
-        # Optional. An opaque value that represents the internal version of this object
-        # that can be used by clients to determine when objects have changed. May be
-        # used for optimistic concurrency, change detection, and the watch operation on
-        # a resource or set of resources. Clients must treat these values as opaque and
-        # passed unmodified back to the server or omit the value to disable conflict-
-        # detection. They may only be valid for a particular resource or set of
-        # resources. Populated by the system. Read-only. Value must be treated as opaque
-        # by clients or omitted. More info: https://git.k8s.io/community/contributors/
-        # devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+        # Opaque, system-generated value that represents the internal version of this
+        # object that can be used by clients to determine when objects have changed. May
+        # be used for optimistic concurrency, change detection, and the watch operation
+        # on a resource or set of resources. Clients must treat these values as opaque
+        # and passed unmodified back to the server or omit the value to disable conflict-
+        # detection. More info: https://git.k8s.io/community/contributors/devel/sig-
+        # architecture/api-conventions.md#concurrency-control-and-consistency
         # Corresponds to the JSON property `resourceVersion`
         # @return [String]
         attr_accessor :resource_version
       
-        # (Optional) SelfLink is a URL representing this object. Populated by the system.
-        # Read-only. string selfLink = 4;
+        # URL representing this object.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
         attr_accessor :self_link
       
-        # (Optional) UID is the unique in time and space value for this object. It is
-        # typically generated by the server on successful creation of a resource and is
-        # not allowed to change on PUT operations. Populated by the system. Read-only.
-        # More info: https://kubernetes.io/docs/user-guide/identifiers#uids
+        # Unique, system-generated identifier for this resource. More info: https://
+        # kubernetes.io/docs/user-guide/identifiers#uids
         # Corresponds to the JSON property `uid`
         # @return [String]
         attr_accessor :uid
@@ -2245,47 +2193,38 @@ module Google
         end
       end
       
-      # OwnerReference contains enough information to let you identify an owning
-      # object. Currently, an owning object must be in the same namespace, so there is
-      # no namespace field.
+      # This is not supported or used by Cloud Run.
       class OwnerReference
         include Google::Apis::Core::Hashable
       
-        # API version of the referent.
+        # This is not supported or used by Cloud Run.
         # Corresponds to the JSON property `apiVersion`
         # @return [String]
         attr_accessor :api_version
       
-        # If true, AND if the owner has the "foregroundDeletion" finalizer, then the
-        # owner cannot be deleted from the key-value store until this reference is
-        # removed. Defaults to false. To set this field, a user needs "delete"
-        # permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.
-        # +optional
+        # This is not supported or used by Cloud Run.
         # Corresponds to the JSON property `blockOwnerDeletion`
         # @return [Boolean]
         attr_accessor :block_owner_deletion
         alias_method :block_owner_deletion?, :block_owner_deletion
       
-        # If true, this reference points to the managing controller. +optional
+        # This is not supported or used by Cloud Run.
         # Corresponds to the JSON property `controller`
         # @return [Boolean]
         attr_accessor :controller
         alias_method :controller?, :controller
       
-        # Kind of the referent. More info: https://git.k8s.io/community/contributors/
-        # devel/sig-architecture/api-conventions.md#types-kinds
+        # This is not supported or used by Cloud Run.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Name of the referent. More info: https://kubernetes.io/docs/user-guide/
-        # identifiers#names
+        # This is not supported or used by Cloud Run.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # UID of the referent. More info: https://kubernetes.io/docs/user-guide/
-        # identifiers#uids
+        # This is not supported or used by Cloud Run.
         # Corresponds to the JSON property `uid`
         # @return [String]
         attr_accessor :uid
@@ -2400,19 +2339,18 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run Probe describes a health check to be performed
-      # against a container to determine whether it is alive or ready to receive
-      # traffic.
+      # Probe describes a health check to be performed against a container to
+      # determine whether it is alive or ready to receive traffic.
       class Probe
         include Google::Apis::Core::Hashable
       
-        # Not supported by Cloud Run ExecAction describes a "run in container" action.
+        # Not supported by Cloud Run. ExecAction describes a "run in container" action.
         # Corresponds to the JSON property `exec`
         # @return [Google::Apis::RunV1::ExecAction]
         attr_accessor :exec
       
-        # (Optional) Minimum consecutive failures for the probe to be considered failed
-        # after having succeeded. Defaults to 3. Minimum value is 1.
+        # Minimum consecutive failures for the probe to be considered failed after
+        # having succeeded. Defaults to 3. Minimum value is 1.
         # Corresponds to the JSON property `failureThreshold`
         # @return [Fixnum]
         attr_accessor :failure_threshold
@@ -2427,8 +2365,8 @@ module Google
         # @return [Google::Apis::RunV1::HttpGetAction]
         attr_accessor :http_get
       
-        # (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
+        # 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. More info:
         # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-
         # probes
@@ -2436,15 +2374,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :initial_delay_seconds
       
-        # (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.
+        # 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.
         # Corresponds to the JSON property `periodSeconds`
         # @return [Fixnum]
         attr_accessor :period_seconds
       
-        # (Optional) Minimum consecutive successes for the probe to be considered
-        # successful after having failed. Must be 1 if set.
+        # Minimum consecutive successes for the probe to be considered successful after
+        # having failed. Must be 1 if set.
         # Corresponds to the JSON property `successThreshold`
         # @return [Fixnum]
         attr_accessor :success_threshold
@@ -2454,10 +2392,10 @@ module Google
         # @return [Google::Apis::RunV1::TcpSocketAction]
         attr_accessor :tcp_socket
       
-        # (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. More info: https://kubernetes.io/docs/concepts/workloads/pods/
-        # pod-lifecycle#container-probes
+        # 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
         # Corresponds to the JSON property `timeoutSeconds`
         # @return [Fixnum]
         attr_accessor :timeout_seconds
@@ -2517,17 +2455,17 @@ module Google
       class ResourceRequirements
         include Google::Apis::Core::Hashable
       
-        # (Optional) Only memory and CPU are supported. Limits describes the maximum
-        # amount of compute resources allowed. The values of the map is string form of
-        # the 'quantity' k8s type: https://github.com/kubernetes/kubernetes/blob/master/
+        # Only memory and CPU are supported. Limits describes the maximum amount of
+        # compute resources allowed. 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
         # Corresponds to the JSON property `limits`
         # @return [Hash<String,String>]
         attr_accessor :limits
       
-        # (Optional) Only memory and CPU are supported. Requests describes the minimum
-        # amount of compute resources required. If Requests is omitted for a container,
-        # it defaults to Limits if that is explicitly specified, otherwise to an
+        # Only memory and CPU are supported. Requests describes the minimum amount of
+        # compute resources required. If Requests is omitted for a container, it
+        # defaults to Limits if that is explicitly specified, otherwise to an
         # implementation-defined value. 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
@@ -2548,8 +2486,8 @@ module Google
       
       # Revision is an immutable snapshot of code and configuration. A revision
       # references a container image. Revisions are created by updates to a
-      # Configuration. See also: https://github.com/knative/serving/blob/main/docs/
-      # spec/overview.md#revision
+      # Configuration. See also: https://github.com/knative/specs/blob/main/specs/
+      # serving/overview.md#revision
       class Revision
         include Google::Apis::Core::Hashable
       
@@ -2599,10 +2537,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # ContainerConcurrency specifies the maximum allowed in-flight (concurrent)
-        # requests per container instance of the Revision. Cloud Run fully managed:
-        # supported, defaults to 80 Cloud Run for Anthos: supported, defaults to 0,
-        # which means concurrency to the application is not limited, and the system
-        # decides the target concurrency for the autoscaler.
+        # requests per container instance of the Revision. If not specified, defaults to
+        # 80.
         # Corresponds to the JSON property `containerConcurrency`
         # @return [Fixnum]
         attr_accessor :container_concurrency
@@ -2611,26 +2547,18 @@ module Google
         # this Revision. In the context of a Revision, we disallow a number of fields on
         # this Container, including: name and lifecycle. In Cloud Run, only a single
         # container may be provided. The runtime contract is documented here: https://
-        # github.com/knative/serving/blob/main/docs/runtime-contract.md
+        # github.com/knative/specs/blob/main/specs/serving/runtime-contract.md
         # Corresponds to the JSON property `containers`
         # @return [Array<Google::Apis::RunV1::Container>]
         attr_accessor :containers
       
-        # Indicates whether information about services should be injected into pod's
-        # environment variables, matching the syntax of Docker links. Cloud Run fully
-        # managed: Not supported. Cloud Run for Anthos: supported, defaults to true.
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `enableServiceLinks`
         # @return [Boolean]
         attr_accessor :enable_service_links
         alias_method :enable_service_links?, :enable_service_links
       
-        # ImagePullSecrets is a list of references to secrets in the same namespace to
-        # use for pulling any images in pods that reference this ServiceAccount.
-        # ImagePullSecrets are distinct from Secrets because Secrets can be mounted in
-        # the pod, but ImagePullSecrets are only accessed by the kubelet. More info:
-        # https://kubernetes.io/docs/concepts/containers/images/#specifying-
-        # imagepullsecrets-on-a-pod Cloud Run fully managed: Not supported. Cloud Run
-        # for Anthos: supported.
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `imagePullSecrets`
         # @return [Array<Google::Apis::RunV1::LocalObjectReference>]
         attr_accessor :image_pull_secrets
@@ -2644,10 +2572,8 @@ module Google
         attr_accessor :service_account_name
       
         # TimeoutSeconds holds the max duration the instance is allowed for responding
-        # to a request. Cloud Run fully managed: defaults to 300 seconds (5 minutes).
-        # Maximum allowed value is 3600 seconds (1 hour). Cloud Run for Anthos: defaults
-        # to 300 seconds (5 minutes). Maximum allowed value is configurable by the
-        # cluster operator.
+        # to a request. Cloud Run: defaults to 300 seconds (5 minutes). Maximum allowed
+        # value is 3600 seconds (1 hour).
         # Corresponds to the JSON property `timeoutSeconds`
         # @return [Fixnum]
         attr_accessor :timeout_seconds
@@ -2678,13 +2604,13 @@ module Google
       class RevisionStatus
         include Google::Apis::Core::Hashable
       
-        # Conditions communicates information about ongoing/complete reconciliation
+        # Conditions communicate information about ongoing/complete reconciliation
         # processes that bring the "spec" inline with the observed state of the world.
         # As a Revision is being prepared, it will incrementally update conditions.
-        # Revision-specific conditions include: * "ResourcesAvailable": True when
-        # underlying resources have been provisioned. * "ContainerHealthy": True when
-        # the Revision readiness check completes. * "Active": True when the Revision may
-        # receive traffic.
+        # Revision-specific conditions include: * `ResourcesAvailable`: `True` when
+        # underlying resources have been provisioned. * `ContainerHealthy`: `True` when
+        # the Revision readiness check completes. * `Active`: `True` when the Revision
+        # may receive traffic.
         # Corresponds to the JSON property `conditions`
         # @return [Array<Google::Apis::RunV1::GoogleCloudRunV1Condition>]
         attr_accessor :conditions
@@ -2763,8 +2689,8 @@ module Google
       # referencing the Configuration responsible for creating them; in these cases
       # the Route is additionally responsible for monitoring the Configuration for "
       # latest ready" revision changes, and smoothly rolling out latest revisions. See
-      # also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route
-      # Cloud Run currently supports referencing a single Configuration to
+      # also: https://github.com/knative/specs/blob/main/specs/serving/overview.md#
+      # route Cloud Run currently supports referencing a single Configuration to
       # automatically deploy the "latest ready" Revision from that Configuration.
       class Route
         include Google::Apis::Core::Hashable
@@ -2858,7 +2784,7 @@ module Google
       
         # Traffic holds the configured traffic distribution. These entries will always
         # contain RevisionName references. When ConfigurationName appears in the spec,
-        # this will hold the LatestReadyRevisionName that we last observed.
+        # this will hold the LatestReadyRevisionName that was last observed.
         # Corresponds to the JSON property `traffic`
         # @return [Array<Google::Apis::RunV1::TrafficTarget>]
         attr_accessor :traffic
@@ -2897,14 +2823,14 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run SecretEnvSource selects a Secret to populate the
+      # Not supported by Cloud Run. SecretEnvSource selects a Secret to populate the
       # environment variables with. The contents of the target Secret's Data field
       # will represent the key-value pairs as environment variables.
       class SecretEnvSource
         include Google::Apis::Core::Hashable
       
-        # Not supported by Cloud Run LocalObjectReference contains enough information to
-        # let you locate the referenced object inside the same namespace.
+        # Not supported by Cloud Run. LocalObjectReference contains enough information
+        # to let you locate the referenced object inside the same namespace.
         # Corresponds to the JSON property `localObjectReference`
         # @return [Google::Apis::RunV1::LocalObjectReference]
         attr_accessor :local_object_reference
@@ -2914,7 +2840,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # (Optional) Specify whether the Secret must be defined
+        # Specify whether the Secret must be defined
         # Corresponds to the JSON property `optional`
         # @return [Boolean]
         attr_accessor :optional
@@ -2936,15 +2862,15 @@ module Google
       class SecretKeySelector
         include Google::Apis::Core::Hashable
       
-        # A Cloud Secret Manager secret version. Must be 'latest' for the latest version
-        # or an integer for a specific version. The key of the secret to select from.
-        # Must be a valid secret key.
+        # Required. A Cloud Secret Manager secret version. Must be 'latest' for the
+        # latest version or an integer for a specific version. The key of the secret to
+        # select from. Must be a valid secret key.
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
       
-        # Not supported by Cloud Run LocalObjectReference contains enough information to
-        # let you locate the referenced object inside the same namespace.
+        # Not supported by Cloud Run. LocalObjectReference contains enough information
+        # to let you locate the referenced object inside the same namespace.
         # Corresponds to the JSON property `localObjectReference`
         # @return [Google::Apis::RunV1::LocalObjectReference]
         attr_accessor :local_object_reference
@@ -2959,7 +2885,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # (Optional) Specify whether the Secret or its key must be defined
+        # Specify whether the Secret or its key must be defined.
         # Corresponds to the JSON property `optional`
         # @return [Boolean]
         attr_accessor :optional
@@ -2978,10 +2904,11 @@ module Google
         end
       end
       
-      # The secret's value will be presented as the content of a file whose name is
-      # defined in the item path. If no items are defined, the name of the file is the
-      # secret_name. The contents of the target Secret's Data field will be presented
-      # in a volume as files using the keys in the Data field as the file names.
+      # A volume representing a secret stored in Google Secret Manager. The secret's
+      # value will be presented as the content of a file whose name is defined in the
+      # item path. If no items are defined, the name of the file is the secret_name.
+      # The contents of the target Secret's Data field will be presented in a volume
+      # as files using the keys in the Data field as the file names.
       class SecretVolumeSource
         include Google::Apis::Core::Hashable
       
@@ -3000,21 +2927,17 @@ module Google
         # @return [Fixnum]
         attr_accessor :default_mode
       
-        # (Optional) If unspecified, the volume will expose a file whose name is the
-        # secret_name. If specified, the key will be used as the version to fetch from
-        # Cloud Secret Manager and the path will be the name of the file exposed in the
-        # volume. When items are defined, they must specify a key and a path. If
-        # unspecified, each key-value pair in the Data field of the referenced Secret
-        # will be projected into the volume as a file whose name is the key and content
-        # is the value. If specified, the listed keys will be projected into the
-        # specified paths, and unlisted keys will not be present. If a key is specified
-        # that is not present in the Secret, the volume setup will error unless it is
-        # marked optional.
+        # A list of secret versions to mount in the volume. If no items are specified,
+        # the volume will expose a file with the same name as the secret name. The
+        # contents of the file will be the data in the latest version of the secret. If
+        # items are specified, the key will be used as the version to fetch from Cloud
+        # Secret Manager and the path will be the name of the file exposed in the volume.
+        # When items are defined, they must specify both a key and a path.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::RunV1::KeyToPath>]
         attr_accessor :items
       
-        # (Optional) Specify whether the Secret or its keys must be defined.
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `optional`
         # @return [Boolean]
         attr_accessor :optional
@@ -3043,15 +2966,15 @@ module Google
         end
       end
       
-      # Not supported by Cloud Run SecurityContext holds security configuration that
+      # Not supported by Cloud Run. SecurityContext holds security configuration that
       # will be applied to a container. Some fields are present in both
       # SecurityContext and PodSecurityContext. When both are set, the values in
       # SecurityContext take precedence.
       class SecurityContext
         include Google::Apis::Core::Hashable
       
-        # (Optional) The UID to run the entrypoint of the container process. Defaults to
-        # user specified in image metadata if unspecified. May also be set in
+        # The UID to run the entrypoint of the container process. Defaults to user
+        # specified in image metadata if unspecified. May also be set in
         # PodSecurityContext. If set in both SecurityContext and PodSecurityContext, the
         # value specified in SecurityContext takes precedence.
         # Corresponds to the JSON property `runAsUser`
@@ -3081,12 +3004,12 @@ module Google
       class Service
         include Google::Apis::Core::Hashable
       
-        # The API version for this call such as "serving.knative.dev/v1".
+        # The API version for this call. It must be "serving.knative.dev/v1".
         # Corresponds to the JSON property `apiVersion`
         # @return [String]
         attr_accessor :api_version
       
-        # The kind of resource, in this case "Service".
+        # The kind of resource. It must be "Service".
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3134,8 +3057,8 @@ module Google
         # @return [Google::Apis::RunV1::RevisionTemplate]
         attr_accessor :template
       
-        # Traffic specifies how to distribute traffic over a collection of Knative
-        # Revisions and Configurations.
+        # Specifies how to distribute traffic over a collection of Knative Revisions and
+        # Configurations to the Service's main URL.
         # Corresponds to the JSON property `traffic`
         # @return [Array<Google::Apis::RunV1::TrafficTarget>]
         attr_accessor :traffic
@@ -3160,49 +3083,45 @@ module Google
         # @return [Google::Apis::RunV1::Addressable]
         attr_accessor :address
       
-        # Conditions communicates information about ongoing/complete reconciliation
-        # processes that bring the "spec" inline with the observed state of the world.
-        # Service-specific conditions include: * "ConfigurationsReady": true when the
-        # underlying Configuration is ready. * "RoutesReady": true when the underlying
-        # Route is ready. * "Ready": true when both the underlying Route and
-        # Configuration are ready.
+        # Conditions communicate information about ongoing/complete reconciliation
+        # processes that bring the `spec` inline with the observed state of the world.
+        # Service-specific conditions include: * `ConfigurationsReady`: `True` when the
+        # underlying Configuration is ready. * `RoutesReady`: `True` when the underlying
+        # Route is ready. * `Ready`: `True` when all underlying resources are ready.
         # Corresponds to the JSON property `conditions`
         # @return [Array<Google::Apis::RunV1::GoogleCloudRunV1Condition>]
         attr_accessor :conditions
       
-        # From ConfigurationStatus. LatestCreatedRevisionName is the last revision that
-        # was created from this Service's Configuration. It might not be ready yet, for
-        # that use LatestReadyRevisionName.
+        # Name of the last revision that was created from this Service's Configuration.
+        # It might not be ready yet, for that use LatestReadyRevisionName.
         # Corresponds to the JSON property `latestCreatedRevisionName`
         # @return [String]
         attr_accessor :latest_created_revision_name
       
-        # From ConfigurationStatus. LatestReadyRevisionName holds the name of the latest
-        # Revision stamped out from this Service's Configuration that has had its "Ready"
-        # condition become "True".
+        # Name of the latest Revision from this Service's Configuration that has had its
+        # `Ready` condition become `True`.
         # Corresponds to the JSON property `latestReadyRevisionName`
         # @return [String]
         attr_accessor :latest_ready_revision_name
       
-        # ObservedGeneration is the 'Generation' of the Route that was last processed by
-        # the controller. Clients polling for completed reconciliation should poll until
-        # observedGeneration = metadata.generation and the Ready condition's status is
-        # True or False.
+        # Returns the generation last fully processed by the system. This will only
+        # match metadata.generation when reconciliation is complete. Clients polling for
+        # completed reconciliation should poll until observedGeneration = metadata.
+        # generation and the Ready condition's status is True or False.
         # Corresponds to the JSON property `observedGeneration`
         # @return [Fixnum]
         attr_accessor :observed_generation
       
-        # From RouteStatus. Traffic holds the configured traffic distribution. These
-        # entries will always contain RevisionName references. When ConfigurationName
-        # appears in the spec, this will hold the LatestReadyRevisionName that we last
-        # observed.
+        # Holds the configured traffic distribution. These entries will always contain
+        # RevisionName references. When ConfigurationName appears in the spec, this will
+        # hold the LatestReadyRevisionName that we last observed.
         # Corresponds to the JSON property `traffic`
         # @return [Array<Google::Apis::RunV1::TrafficTarget>]
         attr_accessor :traffic
       
-        # From RouteStatus. URL holds the url that will distribute traffic over the
-        # provided traffic targets. It generally has the form https://`route-hash`-`
-        # project-hash`-`cluster-level-suffix`.a.run.app
+        # URL that will distribute traffic over the provided traffic targets. It
+        # generally has the form https://`route-hash`-`project-hash`-`cluster-level-
+        # suffix`.a.run.app
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -3276,11 +3195,11 @@ module Google
         end
       end
       
-      # Status is a return value for calls that don't return other objects
+      # Status is a return value for calls that don't return other objects.
       class Status
         include Google::Apis::Core::Hashable
       
-        # Suggested HTTP return code for this status, 0 if not set. +optional
+        # Suggested HTTP return code for this status, 0 if not set.
         # Corresponds to the JSON property `code`
         # @return [Fixnum]
         attr_accessor :code
@@ -3294,28 +3213,27 @@ module Google
         # @return [Google::Apis::RunV1::StatusDetails]
         attr_accessor :details
       
-        # A human-readable description of the status of this operation. +optional
+        # A human-readable description of the status of this operation.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
       
-        # ListMeta describes metadata that synthetic resources must have, including
-        # lists and various status objects. A resource may have only one of `ObjectMeta,
-        # ListMeta`.
+        # Metadata for synthetic resources like List. In Cloud Run, all List Resources
+        # Responses will have a ListMeta instead of ObjectMeta.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::RunV1::ListMeta]
         attr_accessor :metadata
       
         # A machine-readable description of why this operation is in the "Failure"
         # status. If this value is empty there is no information available. A Reason
-        # clarifies an HTTP status code but does not override it. +optional
+        # clarifies an HTTP status code but does not override it.
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
       
         # Status of the operation. One of: "Success" or "Failure". More info: https://
         # git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#
-        # spec-and-status +optional
+        # spec-and-status
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -3343,21 +3261,21 @@ module Google
         # The field of the resource that has caused this error, as named by its JSON
         # serialization. May include dot and postfix notation for nested attributes.
         # Arrays are zero-indexed. Fields may appear more than once in an array of
-        # causes due to fields having multiple errors. Optional. Examples: "name" - the
-        # field "name" on the current resource "items[0].name" - the field "name" on the
-        # first array entry in "items" +optional
+        # causes due to fields having multiple errors. Examples: "name" - the field "
+        # name" on the current resource "items[0].name" - the field "name" on the first
+        # array entry in "items"
         # Corresponds to the JSON property `field`
         # @return [String]
         attr_accessor :field
       
         # A human-readable description of the cause of the error. This field may be
-        # presented as-is to a reader. +optional
+        # presented as-is to a reader.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
       
         # A machine-readable description of the cause of the error. If this value is
-        # empty there is no information available. +optional
+        # empty there is no information available.
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -3383,13 +3301,12 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The Causes array includes more details associated with the StatusReason
-        # failure. Not all StatusReasons may provide detailed causes. +optional
+        # failure. Not all StatusReasons may provide detailed causes.
         # Corresponds to the JSON property `causes`
         # @return [Array<Google::Apis::RunV1::StatusCause>]
         attr_accessor :causes
       
-        # The group attribute of the resource associated with the status StatusReason. +
-        # optional
+        # The group attribute of the resource associated with the status StatusReason.
         # Corresponds to the JSON property `group`
         # @return [String]
         attr_accessor :group
@@ -3397,13 +3314,13 @@ module Google
         # The kind attribute of the resource associated with the status StatusReason. On
         # some operations may differ from the requested resource Kind. More info: https:/
         # /git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#
-        # types-kinds +optional
+        # types-kinds
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
         # The name attribute of the resource associated with the status StatusReason (
-        # when there is a single name which can be described). +optional
+        # when there is a single name which can be described).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3411,13 +3328,13 @@ module Google
         # If specified, the time in seconds before the operation should be retried. Some
         # errors may indicate the client must take an alternate action - for those
         # errors this field may indicate how long to wait before taking the alternate
-        # action. +optional
+        # action.
         # Corresponds to the JSON property `retryAfterSeconds`
         # @return [Fixnum]
         attr_accessor :retry_after_seconds
       
         # UID of the resource. (when there is a single resource which can be described).
-        # More info: https://kubernetes.io/docs/user-guide/identifiers#uids +optional
+        # More info: https://kubernetes.io/docs/user-guide/identifiers#uids
         # Corresponds to the JSON property `uid`
         # @return [String]
         attr_accessor :uid
@@ -3441,15 +3358,12 @@ module Google
       class TcpSocketAction
         include Google::Apis::Core::Hashable
       
-        # (Optional) Optional: Host name to connect to, defaults to the pod IP.
+        # Not supported by Cloud Run.
         # Corresponds to the JSON property `host`
         # @return [String]
         attr_accessor :host
       
-        # Number or name of the port to access on the container. Number must be in the
-        # range 1 to 65535. Name must be an IANA_SVC_NAME. This field is currently
-        # limited to integer types only because of proto's inability to properly support
-        # the IntOrString golang type.
+        # Port number to access on the container. Number must be in the range 1 to 65535.
         # Corresponds to the JSON property `port`
         # @return [Fixnum]
         attr_accessor :port
@@ -3472,7 +3386,7 @@ module Google
         # Optional. APIVersion defines the versioned schema of this representation of an
         # object. Servers should convert recognized schemas to the latest internal value,
         # and may reject unrecognized values. More info: https://git.k8s.io/community/
-        # contributors/devel/sig-architecture/api-conventions.md#resources +optional
+        # contributors/devel/sig-architecture/api-conventions.md#resources
         # Corresponds to the JSON property `apiVersion`
         # @return [String]
         attr_accessor :api_version
@@ -3480,8 +3394,7 @@ module Google
         # Optional. Kind is a string value representing the REST resource this object
         # represents. Servers may infer this from the endpoint the client submits
         # requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/
-        # community/contributors/devel/sig-architecture/api-conventions.md#types-kinds +
-        # optional
+        # community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3497,7 +3410,7 @@ module Google
         # @return [Google::Apis::RunV1::TaskSpec]
         attr_accessor :spec
       
-        # TaskStatus represents the status of a task of a job execution.
+        # TaskStatus represents the status of a task.
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::RunV1::TaskStatus]
         attr_accessor :status
@@ -3566,21 +3479,20 @@ module Google
         # Optional. Email address of the IAM service account associated with the task of
         # a job execution. The service account represents the identity of the running
         # task, and determines what permissions the task has. If not provided, the task
-        # will use the project's default service account. +optional
+        # will use the project's default service account.
         # Corresponds to the JSON property `serviceAccountName`
         # @return [String]
         attr_accessor :service_account_name
       
-        # Optional. Optional duration in seconds the task may be active before the
-        # system will actively try to mark it failed and kill associated containers.
-        # This applies per attempt of a task, meaning each retry can run for the full
-        # timeout. +optional
+        # Optional. Duration in seconds the task may be active before the system will
+        # actively try to mark it failed and kill associated containers. This applies
+        # per attempt of a task, meaning each retry can run for the full timeout.
         # Corresponds to the JSON property `timeoutSeconds`
         # @return [Fixnum]
         attr_accessor :timeout_seconds
       
         # Optional. List of volumes that can be mounted by containers belonging to the
-        # task. More info: https://kubernetes.io/docs/concepts/storage/volumes +optional
+        # task. More info: https://kubernetes.io/docs/concepts/storage/volumes
         # Corresponds to the JSON property `volumes`
         # @return [Array<Google::Apis::RunV1::Volume>]
         attr_accessor :volumes
@@ -3599,20 +3511,22 @@ module Google
         end
       end
       
-      # TaskStatus represents the status of a task of a job execution.
+      # TaskStatus represents the status of a task.
       class TaskStatus
         include Google::Apis::Core::Hashable
       
         # Optional. Represents time when the task was completed. It is not guaranteed to
         # be set in happens-before order across separate operations. It is represented
-        # in RFC3339 form and is in UTC. +optional
+        # in RFC3339 form and is in UTC.
         # Corresponds to the JSON property `completionTime`
         # @return [String]
         attr_accessor :completion_time
       
-        # Optional. The latest available observations of a task's current state. More
-        # info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-
-        # completion/ +optional
+        # Optional. Conditions communicate information about ongoing/complete
+        # reconciliation processes that bring the "spec" inline with the observed state
+        # of the world. Task-specific conditions include: * `Started`: `True` when the
+        # task has started to execute. * `Completed`: `True` when the task has succeeded.
+        # `False` when the task has failed.
         # Corresponds to the JSON property `conditions`
         # @return [Array<Google::Apis::RunV1::GoogleCloudRunV1Condition>]
         attr_accessor :conditions
@@ -3632,21 +3546,21 @@ module Google
         # @return [String]
         attr_accessor :log_uri
       
-        # Optional. The 'generation' of the execution that was last processed by the
+        # Optional. The 'generation' of the task that was last processed by the
         # controller.
         # Corresponds to the JSON property `observedGeneration`
         # @return [Fixnum]
         attr_accessor :observed_generation
       
         # Optional. The number of times this task was retried. Instances are retried
-        # when they fail up to the maxRetries limit. +optional
+        # when they fail up to the maxRetries limit.
         # Corresponds to the JSON property `retried`
         # @return [Fixnum]
         attr_accessor :retried
       
         # Optional. Represents time when the task started to run. It is not guaranteed
         # to be set in happens-before order across separate operations. It is
-        # represented in RFC3339 form and is in UTC. +optional
+        # represented in RFC3339 form and is in UTC.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -3732,12 +3646,12 @@ module Google
       class TrafficTarget
         include Google::Apis::Core::Hashable
       
-        # ConfigurationName of a configuration to whose latest revision we will send
-        # this portion of traffic. When the "status.latestReadyRevisionName" of the
-        # referenced configuration changes, we will automatically migrate traffic from
-        # the prior "latest ready" revision to the new one. This field is never set in
-        # Route's status, only its spec. This is mutually exclusive with RevisionName.
-        # Cloud Run currently supports a single ConfigurationName.
+        # ConfigurationName of a configuration to whose latest revision which will be
+        # sent this portion of traffic. When the "status.latestReadyRevisionName" of the
+        # referenced configuration changes, traffic will automatically migrate from the
+        # prior "latest ready" revision to the new one. This field is never set in Route'
+        # s status, only its spec. This is mutually exclusive with RevisionName. Cloud
+        # Run currently supports a single ConfigurationName.
         # Corresponds to the JSON property `configurationName`
         # @return [String]
         attr_accessor :configuration_name
@@ -3796,7 +3710,7 @@ module Google
       class Volume
         include Google::Apis::Core::Hashable
       
-        # Not supported by Cloud Run Adapts a ConfigMap into a volume. The contents of
+        # Not supported by Cloud Run. Adapts a ConfigMap into a volume. The contents of
         # the target ConfigMap's Data field will be presented in a volume as files using
         # the keys in the Data field as the file names, unless the items element is
         # populated with specific mappings of keys to paths.
@@ -3809,10 +3723,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The secret's value will be presented as the content of a file whose name is
-        # defined in the item path. If no items are defined, the name of the file is the
-        # secret_name. The contents of the target Secret's Data field will be presented
-        # in a volume as files using the keys in the Data field as the file names.
+        # A volume representing a secret stored in Google Secret Manager. The secret's
+        # value will be presented as the content of a file whose name is defined in the
+        # item path. If no items are defined, the name of the file is the secret_name.
+        # The contents of the target Secret's Data field will be presented in a volume
+        # as files using the keys in the Data field as the file names.
         # Corresponds to the JSON property `secret`
         # @return [Google::Apis::RunV1::SecretVolumeSource]
         attr_accessor :secret
@@ -3833,26 +3748,26 @@ module Google
       class VolumeMount
         include Google::Apis::Core::Hashable
       
-        # Path within the container at which the volume should be mounted. Must not
-        # contain ':'.
+        # Required. Path within the container at which the volume should be mounted.
+        # Must not contain ':'.
         # Corresponds to the JSON property `mountPath`
         # @return [String]
         attr_accessor :mount_path
       
-        # The name of the volume. There must be a corresponding Volume with the same
-        # name.
+        # Required. The name of the volume. There must be a corresponding Volume with
+        # the same name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # (Optional) Only true is accepted. Defaults to true.
+        # Only true is accepted for Secret Volumes. Defaults to true for Secrets Volumes.
         # Corresponds to the JSON property `readOnly`
         # @return [Boolean]
         attr_accessor :read_only
         alias_method :read_only?, :read_only
       
-        # (Optional) Path within the volume from which the container's volume should be
-        # mounted. Defaults to "" (volume's root).
+        # Path within the volume from which the container's volume should be mounted.
+        # Defaults to "" (volume's root).
         # Corresponds to the JSON property `subPath`
         # @return [String]
         attr_accessor :sub_path