REST Resource: projects.locations.services.revisions

Resource: Revision

A Revision is an immutable snapshot of code and configuration. A Revision references a container image. Revisions are only created by updates to its parent Service.

JSON representation
{
  "name": string,
  "uid": string,
  "generation": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "expireTime": string,
  "launchStage": enum (LaunchStage),
  "service": string,
  "scaling": {
    object (RevisionScaling)
  },
  "vpcAccess": {
    object (VpcAccess)
  },
  "maxInstanceRequestConcurrency": integer,
  "timeout": string,
  "serviceAccount": string,
  "containers": [
    {
      object (Container)
    }
  ],
  "volumes": [
    {
      object (Volume)
    }
  ],
  "executionEnvironment": enum (ExecutionEnvironment),
  "encryptionKey": string,
  "serviceMesh": {
    object (ServiceMesh)
  },
  "encryptionKeyRevocationAction": enum (EncryptionKeyRevocationAction),
  "encryptionKeyShutdownDuration": string,
  "reconciling": boolean,
  "conditions": [
    {
      object (Condition)
    }
  ],
  "observedGeneration": string,
  "logUri": string,
  "satisfiesPzs": boolean,
  "sessionAffinity": boolean,
  "scalingStatus": {
    object (RevisionScalingStatus)
  },
  "nodeSelector": {
    object (NodeSelector)
  },
  "etag": string
}
Fields
name

string

Output only. The unique name of this Revision.

uid

string

Output only. Server assigned unique identifier for the Revision. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.

generation

string (int64 format)

Output only. A number that monotonically increases every time the user modifies the desired state.

labels

map (key: string, value: string)

Output only. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

Output only. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

createTime

string (Timestamp format)

Output only. The creation time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The last-modified time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

deleteTime

string (Timestamp format)

Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

expireTime

string (Timestamp format)

Output only. For a deleted resource, the time after which it will be permamently deleted. It is only populated as a response to a Delete request.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

launchStage

enum (LaunchStage)

The least stable launch stage needed to create this resource, as defined by Google Cloud Platform Launch Stages. Cloud Run supports ALPHA, BETA, and GA.

Note that this value might not be what was used as input. For example, if ALPHA was provided as input in the parent resource, but only BETA and GA-level features are were, this field will be BETA.

service

string

Output only. The name of the parent service.

scaling

object (RevisionScaling)

Scaling settings for this revision.

vpcAccess

object (VpcAccess)

VPC Access configuration for this Revision. For more information, visit https://cloud.google.com/run/docs/configuring/connecting-vpc.

maxInstanceRequestConcurrency

integer

Sets the maximum number of requests that each serving instance can receive.

timeout

string (Duration format)

Max allowed time for an instance to respond to a request.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".

serviceAccount

string

Email address of the IAM service account associated with the revision of the service. The service account represents the identity of the running revision, and determines what permissions the revision has.

containers[]

object (Container)

Holds the single container that defines the unit of execution for this Revision.

volumes[]

object (Volume)

A list of Volumes to make available to containers.

executionEnvironment

enum (ExecutionEnvironment)

The execution environment being used to host this Revision.

encryptionKey

string

A reference to a customer managed encryption key (CMEK) to use to encrypt this container image. For more information, go to https://cloud.google.com/run/docs/securing/using-cmek

serviceMesh

object (ServiceMesh)

Enables service mesh connectivity.

encryptionKeyRevocationAction

enum (EncryptionKeyRevocationAction)

The action to take if the encryption key is revoked.

encryptionKeyShutdownDuration

string (Duration format)

If encryptionKeyRevocationAction is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".

reconciling

boolean

Output only. Indicates whether the resource's reconciliation is still in progress. See comments in Service.reconciling for additional information on reconciliation process in Cloud Run.

conditions[]

object (Condition)

Output only. The Condition of this Revision, containing its readiness status, and detailed error information in case it did not reach a serving state.

observedGeneration

string (int64 format)

Output only. The generation of this Revision currently serving traffic. See comments in reconciling for additional information on reconciliation process in Cloud Run.

logUri

string

Output only. The Google Console URI to obtain logs for the Revision.

satisfiesPzs

boolean

Output only. Reserved for future use.

sessionAffinity

boolean

Enable session affinity.

scalingStatus

object (RevisionScalingStatus)

Output only. The current effective scaling settings for the revision.

nodeSelector

object (NodeSelector)

The node selector for the revision.

etag

string

Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.

EncryptionKeyRevocationAction

Specifies behavior if an encryption key used by a resource is revoked.

Enums
ENCRYPTION_KEY_REVOCATION_ACTION_UNSPECIFIED Unspecified
PREVENT_NEW Prevents the creation of new instances.
SHUTDOWN Shuts down existing instances, and prevents creation of new ones.

RevisionScalingStatus

Effective settings for the current revision

JSON representation
{
  "desiredMinInstanceCount": integer
}
Fields
desiredMinInstanceCount

integer

The current number of min instances provisioned for this revision.

Methods

delete

Deletes a Revision.

get

Gets information about a Revision.

list

Lists Revisions from a given Service, or from a given location.