Reference documentation and code samples for the Google Cloud Run V2 Client class 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.
Generated from protobuf message google.cloud.run.v2.Revision
Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ 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
int|string
Output only. A number that monotonically increases every time the user modifies the desired state.
↳ labels
array| Google\Protobuf\Internal\MapField
KRM-style labels for the resource. 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
↳ annotations
↳ create_time
↳ update_time
↳ delete_time
Google\Protobuf\Timestamp
Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.
↳ expire_time
Google\Protobuf\Timestamp
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.
↳ launch_stage
int
Set the launch stage to a preview stage on write to allow use of preview features in that stage. On read, describes whether the resource uses preview features. Launch Stages are defined at Google Cloud Platform Launch Stages .
↳ service
string
Output only. The name of the parent service.
↳ scaling
↳ vpc_access
Google\Cloud\Run\V2\VpcAccess
VPC Access configuration for this Revision. For more information, visit https://cloud.google.com/run/docs/configuring/connecting-vpc .
↳ max_instance_request_concurrency
int
Sets the maximum number of requests that each serving instance can receive.
↳ timeout
↳ service_account
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
array< Google\Cloud\Run\V2\Container
>
Holds the single container that defines the unit of execution for this Revision.
↳ volumes
↳ execution_environment
int
The execution environment being used to host this Revision.
↳ encryption_key
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
↳ encryption_key_revocation_action
int
The action to take if the encryption key is revoked.
↳ encryption_key_shutdown_duration
Google\Protobuf\Duration
If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.
↳ reconciling
bool
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
array< Google\Cloud\Run\V2\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.
↳ observed_generation
int|string
Output only. The generation of this Revision currently serving traffic. See comments in reconciling
for additional information on reconciliation process in Cloud Run.
↳ log_uri
string
Output only. The Google Console URI to obtain logs 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.
getName
Output only. The unique name of this Revision.
string
setName
Output only. The unique name of this Revision.
var
string
$this
getUid
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.
string
setUid
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.
var
string
$this
getGeneration
Output only. A number that monotonically increases every time the user modifies the desired state.
int|string
setGeneration
Output only. A number that monotonically increases every time the user modifies the desired state.
var
int|string
$this
getLabels
KRM-style labels for the resource.
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
setLabels
KRM-style labels for the resource.
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
$this
getAnnotations
KRM-style annotations for the resource.
setAnnotations
KRM-style annotations for the resource.
$this
getCreateTime
Output only. The creation time.
hasCreateTime
clearCreateTime
setCreateTime
Output only. The creation time.
$this
getUpdateTime
Output only. The last-modified time.
hasUpdateTime
clearUpdateTime
setUpdateTime
Output only. The last-modified time.
$this
getDeleteTime
Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.
hasDeleteTime
clearDeleteTime
setDeleteTime
Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.
$this
getExpireTime
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.
hasExpireTime
clearExpireTime
setExpireTime
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.
$this
getLaunchStage
Set the launch stage to a preview stage on write to allow use of preview features in that stage. On read, describes whether the resource uses preview features. Launch Stages are defined at Google Cloud Platform Launch Stages .
int
setLaunchStage
Set the launch stage to a preview stage on write to allow use of preview features in that stage. On read, describes whether the resource uses preview features. Launch Stages are defined at Google Cloud Platform Launch Stages .
var
int
$this
getService
Output only. The name of the parent service.
string
setService
Output only. The name of the parent service.
var
string
$this
getScaling
Scaling settings for this revision.
hasScaling
clearScaling
setScaling
Scaling settings for this revision.
$this
getVpcAccess
VPC Access configuration for this Revision. For more information, visit https://cloud.google.com/run/docs/configuring/connecting-vpc .
hasVpcAccess
clearVpcAccess
setVpcAccess
VPC Access configuration for this Revision. For more information, visit https://cloud.google.com/run/docs/configuring/connecting-vpc .
$this
getMaxInstanceRequestConcurrency
Sets the maximum number of requests that each serving instance can receive.
int
setMaxInstanceRequestConcurrency
Sets the maximum number of requests that each serving instance can receive.
var
int
$this
getTimeout
Max allowed time for an instance to respond to a request.
hasTimeout
clearTimeout
setTimeout
Max allowed time for an instance to respond to a request.
$this
getServiceAccount
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.
string
setServiceAccount
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.
var
string
$this
getContainers
Holds the single container that defines the unit of execution for this Revision.
setContainers
Holds the single container that defines the unit of execution for this Revision.
$this
getVolumes
A list of Volumes to make available to containers.
setVolumes
A list of Volumes to make available to containers.
$this
getExecutionEnvironment
The execution environment being used to host this Revision.
int
setExecutionEnvironment
The execution environment being used to host this Revision.
var
int
$this
getEncryptionKey
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
string
setEncryptionKey
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
var
string
$this
getEncryptionKeyRevocationAction
The action to take if the encryption key is revoked.
int
setEncryptionKeyRevocationAction
The action to take if the encryption key is revoked.
var
int
$this
getEncryptionKeyShutdownDuration
If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.
hasEncryptionKeyShutdownDuration
clearEncryptionKeyShutdownDuration
setEncryptionKeyShutdownDuration
If encryption_key_revocation_action is SHUTDOWN, the duration before shutting down all instances. The minimum increment is 1 hour.
$this
getReconciling
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.
bool
setReconciling
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.
var
bool
$this
getConditions
Output only. The Condition of this Revision, containing its readiness status, and detailed error information in case it did not reach a serving state.
setConditions
Output only. The Condition of this Revision, containing its readiness status, and detailed error information in case it did not reach a serving state.
$this
getObservedGeneration
Output only. The generation of this Revision currently serving traffic. See
comments in reconciling
for additional information on reconciliation
process in Cloud Run.
int|string
setObservedGeneration
Output only. The generation of this Revision currently serving traffic. See
comments in reconciling
for additional information on reconciliation
process in Cloud Run.
var
int|string
$this
getLogUri
Output only. The Google Console URI to obtain logs for the Revision.
string
setLogUri
Output only. The Google Console URI to obtain logs for the Revision.
var
string
$this
getEtag
Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
string
setEtag
Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
var
string
$this