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.

Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source.

See also: https://github.com/knative/serving/blob/master/docs/spec/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/v1alpha1".

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
{
  "logUrl": string,
  "conditions": [
    {
      object (RevisionCondition)
    }
  ],
  "serviceName": string,
  "observedGeneration": number,
  "imageDigest": string
}
Fields
logUrl

string

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

conditions[]

object (RevisionCondition)

Conditions communicates 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 "ResourcesAvailable", "ContainerHealthy", and "Active", which contribute to the overall "Ready" condition.

serviceName

string

Not currently used by Cloud Run.

observedGeneration

number

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.

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.

RevisionCondition

RevisionCondition defines a readiness condition for a Revision.

JSON representation
{
  "type": string,
  "status": string,
  "reason": string,
  "message": string,
  "lastTransitionTime": string,
  "severity": string
}
Fields
type

string

RevisionConditionType is used to communicate the status of the reconciliation process. See also: https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting Types include:

  • "Ready": True when the Revision is ready.
  • "ResourcesAvailable": True when underlying resources have been provisioned.
  • "ContainerHealthy": True when the Revision readiness check completes.
  • "Active": True when the Revision may receive traffic.

status

string

Status of the condition, one of True, False, Unknown.

reason

string

One-word CamelCase reason for the condition's last transition. +optional

message

string

Human readable message indicating details about the current status. +optional

lastTransitionTime

string (Timestamp format)

Last time the condition transitioned from one status to another. +optional

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

severity

string

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

Methods

delete

Rpc to delete a revision.

get

Rpc to get information about a revision.

list

Rpc to list revisions.
Was this page helpful? Let us know how we did:

Send feedback about...