REST Resource: namespaces.revisions

Resource: Revision

Revision is an immutable snapshot of code and configuration. A revision references one or more container images. Revisions are created by updates to a Service.

JSON representation
{"apiVersion":string,"kind":string,"metadata":{object (ObjectMeta)},"spec":{object (RevisionSpec)},"status":{object (RevisionStatus)}}
Fields
apiVersion

string

The API version for this call such as "serving.knative.dev/v1".

kind

string

The kind of this resource, in this case "Revision".

metadata

object (ObjectMeta)

Metadata associated with this Revision, including name, namespace, labels, and annotations.

spec

object (RevisionSpec)

Spec holds the desired state of the Revision (from the client).

status

object (RevisionStatus)

Status communicates the observed state of the Revision (from the controller).

RevisionStatus

RevisionStatus communicates the observed state of the Revision (from the controller).

JSON representation
{"observedGeneration":integer,"conditions":[{object (Condition)}],"logUrl":string,"serviceName":string,"imageDigest":string,"desiredReplicas":integer}
Fields
observedGeneration

integer

ObservedGeneration is the 'Generation' of the Revision 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.

conditions[]

object (Condition)

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.
logUrl

string

Optional. Specifies the generated logging url for this particular revision based on the revision url template specified in the controller's config.

serviceName

string

Not currently used by Cloud Run.

imageDigest

string

ImageDigest holds the resolved digest for the image specified within .Spec.Container.Image. The digest is resolved during the creation of Revision. This field holds the digest value regardless of whether a tag or digest was originally specified in the Container object.

desiredReplicas

integer

Output only. The configured number of instances running this revision. For Cloud Run, this only includes instances provisioned using the minScale annotation. It does not include instances created by autoscaling.

Methods

delete

 Delete a revision.

get

 Get information about a revision.

list

 List revisions.

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.