Console
    Contact Us Start free

    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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: