REST Resource: namespaces.revisions

Resource: Revision

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/specs/blob/main/specs/serving/overview.md#revision

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.