revisions

Creates, updates, deletes, gets or lists a revisions resource.

Overview

Name	revisions
Type	Resource
Id	google.run.revisions

Fields

The following fields are returned by SELECT queries:

get

Successful response

Name	Datatype	Description
name	string	Output only. The unique name of this Revision.
annotations	object	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.
conditions	array	Output only. The Condition of this Revision, containing its readiness status, and detailed error information in case it did not reach a serving state.
containers	array	Holds the single container that defines the unit of execution for this Revision.
createTime	string (google-datetime)	Output only. The creation time.
creator	string	Output only. Email address of the authenticated creator.
deleteTime	string (google-datetime)	Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.
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
encryptionKeyRevocationAction	string	The action to take if the encryption key is revoked.
encryptionKeyShutdownDuration	string (google-duration)	If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.
etag	string	Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
executionEnvironment	string	The execution environment being used to host this Revision.
expireTime	string (google-datetime)	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.
generation	string (int64)	Output only. A number that monotonically increases every time the user modifies the desired state.
gpuZonalRedundancyDisabled	boolean	Optional. Output only. True if GPU zonal redundancy is disabled on this revision.
labels	object	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.
launchStage	string	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.
logUri	string	Output only. The Google Console URI to obtain logs for the Revision.
maxInstanceRequestConcurrency	integer (int32)	Sets the maximum number of requests that each serving instance can receive.
nodeSelector	object	The node selector for the revision. (id: GoogleCloudRunV2NodeSelector)
observedGeneration	string (int64)	Output only. The generation of this Revision currently serving traffic. See comments in reconciling for additional information on reconciliation process in Cloud Run.
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.
satisfiesPzs	boolean	Output only. Reserved for future use.
scaling	object	Scaling settings for this revision. (id: GoogleCloudRunV2RevisionScaling)
scalingStatus	object	Output only. The current effective scaling settings for the revision. (id: GoogleCloudRunV2RevisionScalingStatus)
service	string	Output only. The name of the parent service.
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.
serviceMesh	object	Enables service mesh connectivity. (id: GoogleCloudRunV2ServiceMesh)
sessionAffinity	boolean	Enable session affinity.
timeout	string (google-duration)	Max allowed time for an instance to respond to a request.
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.
updateTime	string (google-datetime)	Output only. The last-modified time.
volumes	array	A list of Volumes to make available to containers.
vpcAccess	object	VPC Access configuration for this Revision. For more information, visit https://cloud.google.com/run/docs/configuring/connecting-vpc. (id: GoogleCloudRunV2VpcAccess)

list

Successful response

Name	Datatype	Description
name	string	Output only. The unique name of this Revision.
annotations	object	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.
conditions	array	Output only. The Condition of this Revision, containing its readiness status, and detailed error information in case it did not reach a serving state.
containers	array	Holds the single container that defines the unit of execution for this Revision.
createTime	string (google-datetime)	Output only. The creation time.
creator	string	Output only. Email address of the authenticated creator.
deleteTime	string (google-datetime)	Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.
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
encryptionKeyRevocationAction	string	The action to take if the encryption key is revoked.
encryptionKeyShutdownDuration	string (google-duration)	If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.
etag	string	Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
executionEnvironment	string	The execution environment being used to host this Revision.
expireTime	string (google-datetime)	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.
generation	string (int64)	Output only. A number that monotonically increases every time the user modifies the desired state.
gpuZonalRedundancyDisabled	boolean	Optional. Output only. True if GPU zonal redundancy is disabled on this revision.
labels	object	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.
launchStage	string	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.
logUri	string	Output only. The Google Console URI to obtain logs for the Revision.
maxInstanceRequestConcurrency	integer (int32)	Sets the maximum number of requests that each serving instance can receive.
nodeSelector	object	The node selector for the revision. (id: GoogleCloudRunV2NodeSelector)
observedGeneration	string (int64)	Output only. The generation of this Revision currently serving traffic. See comments in reconciling for additional information on reconciliation process in Cloud Run.
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.
satisfiesPzs	boolean	Output only. Reserved for future use.
scaling	object	Scaling settings for this revision. (id: GoogleCloudRunV2RevisionScaling)
scalingStatus	object	Output only. The current effective scaling settings for the revision. (id: GoogleCloudRunV2RevisionScalingStatus)
service	string	Output only. The name of the parent service.
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.
serviceMesh	object	Enables service mesh connectivity. (id: GoogleCloudRunV2ServiceMesh)
sessionAffinity	boolean	Enable session affinity.
timeout	string (google-duration)	Max allowed time for an instance to respond to a request.
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.
updateTime	string (google-datetime)	Output only. The last-modified time.
volumes	array	A list of Volumes to make available to containers.
vpcAccess	object	VPC Access configuration for this Revision. For more information, visit https://cloud.google.com/run/docs/configuring/connecting-vpc. (id: GoogleCloudRunV2VpcAccess)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, workerPoolsId, revisionsId		Gets information about a Revision.
list	select	projectsId, locationsId, workerPoolsId	pageSize, pageToken, showDeleted	Lists Revisions from a given Service, or from a given location. Results are sorted by creation time, descending.
delete	delete	projectsId, locationsId, workerPoolsId, revisionsId	validateOnly, etag	Deletes a Revision.
export_status	exec	projectsId, locationsId, servicesId, revisionsId, revisionsId1		Read the status of an image export operation.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
locationsId	string
projectsId	string
revisionsId	string
revisionsId1	string
servicesId	string
workerPoolsId	string
etag	string
pageSize	integer (int32)
pageToken	string
showDeleted	boolean
validateOnly	boolean

SELECT examples

get

Gets information about a Revision.

SELECT
name,
annotations,
conditions,
containers,
createTime,
creator,
deleteTime,
encryptionKey,
encryptionKeyRevocationAction,
encryptionKeyShutdownDuration,
etag,
executionEnvironment,
expireTime,
generation,
gpuZonalRedundancyDisabled,
labels,
launchStage,
logUri,
maxInstanceRequestConcurrency,
nodeSelector,
observedGeneration,
reconciling,
satisfiesPzs,
scaling,
scalingStatus,
service,
serviceAccount,
serviceMesh,
sessionAffinity,
timeout,
uid,
updateTime,
volumes,
vpcAccess
FROM google.run.revisions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND workerPoolsId = '{{ workerPoolsId }}' -- required
AND revisionsId = '{{ revisionsId }}' -- required;

list

Lists Revisions from a given Service, or from a given location. Results are sorted by creation time, descending.

SELECT
name,
annotations,
conditions,
containers,
createTime,
creator,
deleteTime,
encryptionKey,
encryptionKeyRevocationAction,
encryptionKeyShutdownDuration,
etag,
executionEnvironment,
expireTime,
generation,
gpuZonalRedundancyDisabled,
labels,
launchStage,
logUri,
maxInstanceRequestConcurrency,
nodeSelector,
observedGeneration,
reconciling,
satisfiesPzs,
scaling,
scalingStatus,
service,
serviceAccount,
serviceMesh,
sessionAffinity,
timeout,
uid,
updateTime,
volumes,
vpcAccess
FROM google.run.revisions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND workerPoolsId = '{{ workerPoolsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND showDeleted = '{{ showDeleted }}';

DELETE examples

delete

Deletes a Revision.

DELETE FROM google.run.revisions
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND workerPoolsId = '{{ workerPoolsId }}' --required
AND revisionsId = '{{ revisionsId }}' --required
AND validateOnly = '{{ validateOnly }}'
AND etag = '{{ etag }}';

Lifecycle Methods

export_status

Read the status of an image export operation.

EXEC google.run.revisions.export_status 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@servicesId='{{ servicesId }}' --required, 
@revisionsId='{{ revisionsId }}' --required, 
@revisionsId1='{{ revisionsId1 }}' --required;