Condition

Defines a status condition for a resource.

JSON representation
{"type":string,"state":enum (State),"message":string,"lastTransitionTime":string,"severity":enum (Severity),// Union fieldreasons can be only one of the following:"reason":enum (CommonReason),"revisionReason":enum (RevisionReason),"executionReason":enum (ExecutionReason)// End of list of possible types for union fieldreasons.}
Fields
type

string

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.

state

enum (State)

State of the condition.

message

string

Human readable message indicating details about the current status.

lastTransitionTime

string (Timestamp format)

Last time the condition transitioned from one status to another.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples:"2014-10-02T15:01:23Z","2014-10-02T15:01:23.045123456Z" or"2014-10-02T15:01:23+05:30".

severity

enum (Severity)

How to interpret failures of this condition, one of Error, Warning, Info

Union fieldreasons. The reason for this condition. Depending on the condition type, it will populate one of these fields. Successful conditions cannot have a reason.reasons can be only one of the following:
reason

enum (CommonReason)

Output only. A common (service-level) reason for this condition.

revisionReason

enum (RevisionReason)

Output only. A reason for the revision condition.

executionReason

enum (ExecutionReason)

Output only. A reason for the execution condition.

State

Represents the possible Condition states.

Enums
STATE_UNSPECIFIEDThe default value. This value is used if the state is omitted.
CONDITION_PENDINGTransient state: Reconciliation has not started yet.
CONDITION_RECONCILINGTransient state: reconciliation is still in progress.
CONDITION_FAILEDTerminal state: Reconciliation did not succeed.
CONDITION_SUCCEEDEDTerminal state: Reconciliation completed successfully.

Severity

Represents the severity of the condition failures.

Enums
SEVERITY_UNSPECIFIEDUnspecified severity
ERRORError severity.
WARNINGWarning severity.
INFOInfo severity.

CommonReason

Reasons common to all types of conditions.

Enums
COMMON_REASON_UNDEFINEDDefault value.
UNKNOWNReason unknown. Further details will be in message.
REVISION_FAILEDRevision creation process failed.
PROGRESS_DEADLINE_EXCEEDEDTimed out waiting for completion.
CONTAINER_MISSINGThe container image path is incorrect.
CONTAINER_PERMISSION_DENIEDInsufficient permissions on the container image.
CONTAINER_IMAGE_UNAUTHORIZEDContainer image is not authorized by policy.
CONTAINER_IMAGE_AUTHORIZATION_CHECK_FAILEDContainer image policy authorization check failed.
ENCRYPTION_KEY_PERMISSION_DENIEDInsufficient permissions on encryption key.
ENCRYPTION_KEY_CHECK_FAILEDPermission check on encryption key failed.
SECRETS_ACCESS_CHECK_FAILEDAt least one Access check on secrets failed.
WAITING_FOR_OPERATIONWaiting for operation to complete.
IMMEDIATE_RETRYSystem will retry immediately.
POSTPONED_RETRYSystem will retry later; current attempt failed.
INTERNALAn internal error occurred. Further information may be in the message.
VPC_NETWORK_NOT_FOUNDUser-provided VPC network was not found.

RevisionReason

Reasons specific to Revision resource.

Enums
REVISION_REASON_UNDEFINEDDefault value.
PENDINGRevision in Pending state.
RESERVERevision is in Reserve state.
RETIREDRevision is Retired.
RETIRINGRevision is being retired.
RECREATINGRevision is being recreated.
HEALTH_CHECK_CONTAINER_ERRORThere was a health check error.
CUSTOMIZED_PATH_RESPONSE_PENDINGHealth check failed due to user error from customized path of the container. System will retry.
MIN_INSTANCES_NOT_PROVISIONEDA revision with minInstanceCount > 0 was created and is reserved, but it was not configured to serve traffic, so it's not live. This can also happen momentarily during traffic migration.
ACTIVE_REVISION_LIMIT_REACHEDThe maximum allowed number of active revisions has been reached.
NO_DEPLOYMENTThere was no deployment defined. This value is no longer used, but Services created in older versions of the API might contain this value.
HEALTH_CHECK_SKIPPEDA revision's container has no port specified since the revision is of a manually scaled service with 0 instance count
MIN_INSTANCES_WARMINGA revision with minInstanceCount > 0 was created and is waiting for enough instances to begin a traffic migration.

ExecutionReason

Reasons specific to Execution resource.

Enums
EXECUTION_REASON_UNDEFINEDDefault value.
JOB_STATUS_SERVICE_POLLING_ERRORInternal system error getting execution status. System will retry.
NON_ZERO_EXIT_CODEA task reached its retry limit and the last attempt failed due to the user container exiting with a non-zero exit code.
CANCELLEDThe execution was cancelled by users.
CANCELLINGThe execution is in the process of being cancelled.
DELETEDThe execution was deleted.
DELAYED_START_PENDINGA delayed execution is waiting for a start time.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-10 UTC.