Google Cloud Run V2 Client - Class Execution (0.8.0)

Reference documentation and code samples for the Google Cloud Run V2 Client class Execution.

Execution represents the configuration of a single execution. A execution an immutable resource that references a container image which is run to completion.

Generated from protobuf message google.cloud.run.v2.Execution

Namespace

Google \ Cloud \ Run \ V2

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ name string

Output only. The unique name of this Execution.

↳ uid string

Output only. Server assigned unique identifier for the Execution. 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

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

↳ annotations array|Google\Protobuf\Internal\MapField

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.

↳ create_time Google\Protobuf\Timestamp

Output only. Represents time when the execution was acknowledged by the execution controller. It is not guaranteed to be set in happens-before order across separate operations.

↳ start_time Google\Protobuf\Timestamp

Output only. Represents time when the execution started to run. It is not guaranteed to be set in happens-before order across separate operations.

↳ completion_time Google\Protobuf\Timestamp

Output only. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations.

↳ update_time Google\Protobuf\Timestamp

Output only. The last-modified 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

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.

↳ job string

Output only. The name of the parent Job.

↳ parallelism int

Output only. Specifies the maximum desired number of tasks the execution should run at any given time. Must be <= task_count. The actual number of tasks running in steady state will be less than this number when ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when the work left to do is less than max parallelism.

↳ task_count int

Output only. Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution.

↳ template Google\Cloud\Run\V2\TaskTemplate

Output only. The template used to create tasks for this execution.

↳ reconciling bool

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

↳ conditions array<Google\Cloud\Run\V2\Condition>

Output only. The Condition of this Execution, containing its readiness status, and detailed error information in case it did not reach the desired state.

↳ observed_generation int|string

Output only. The generation of this Execution. See comments in reconciling for additional information on reconciliation process in Cloud Run.

↳ running_count int

Output only. The number of actively running tasks.

↳ succeeded_count int

Output only. The number of tasks which reached phase Succeeded.

↳ failed_count int

Output only. The number of tasks which reached phase Failed.

↳ cancelled_count int

Output only. The number of tasks which reached phase Cancelled.

↳ retried_count int

Output only. The number of tasks which have retried at least once.

↳ log_uri string

Output only. URI where logs for this execution can be found in Cloud Console.

↳ satisfies_pzs bool

Output only. Reserved for future use.

↳ 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 Execution.

Returns
TypeDescription
string

setName

Output only. The unique name of this Execution.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getUid

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

Returns
TypeDescription
string

setUid

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

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getGeneration

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

Returns
TypeDescription
int|string

setGeneration

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

Parameter
NameDescription
var int|string
Returns
TypeDescription
$this

getLabels

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

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setLabels

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

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getAnnotations

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.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setAnnotations

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.

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getCreateTime

Output only. Represents time when the execution was acknowledged by the execution controller. It is not guaranteed to be set in happens-before order across separate operations.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Represents time when the execution was acknowledged by the execution controller. It is not guaranteed to be set in happens-before order across separate operations.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getStartTime

Output only. Represents time when the execution started to run.

It is not guaranteed to be set in happens-before order across separate operations.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasStartTime

clearStartTime

setStartTime

Output only. Represents time when the execution started to run.

It is not guaranteed to be set in happens-before order across separate operations.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getCompletionTime

Output only. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCompletionTime

clearCompletionTime

setCompletionTime

Output only. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getUpdateTime

Output only. The last-modified time.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. The last-modified time.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getDeleteTime

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

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasDeleteTime

clearDeleteTime

setDeleteTime

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

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$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.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

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.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getLaunchStage

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.

Returns
TypeDescription
int

setLaunchStage

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.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getJob

Output only. The name of the parent Job.

Returns
TypeDescription
string

setJob

Output only. The name of the parent Job.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getParallelism

Output only. Specifies the maximum desired number of tasks the execution should run at any given time. Must be <= task_count. The actual number of tasks running in steady state will be less than this number when ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when the work left to do is less than max parallelism.

Returns
TypeDescription
int

setParallelism

Output only. Specifies the maximum desired number of tasks the execution should run at any given time. Must be <= task_count. The actual number of tasks running in steady state will be less than this number when ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when the work left to do is less than max parallelism.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getTaskCount

Output only. Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution.

Returns
TypeDescription
int

setTaskCount

Output only. Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getTemplate

Output only. The template used to create tasks for this execution.

Returns
TypeDescription
Google\Cloud\Run\V2\TaskTemplate|null

hasTemplate

clearTemplate

setTemplate

Output only. The template used to create tasks for this execution.

Parameter
NameDescription
var Google\Cloud\Run\V2\TaskTemplate
Returns
TypeDescription
$this

getReconciling

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

Returns
TypeDescription
bool

setReconciling

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

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getConditions

Output only. The Condition of this Execution, containing its readiness status, and detailed error information in case it did not reach the desired state.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setConditions

Output only. The Condition of this Execution, containing its readiness status, and detailed error information in case it did not reach the desired state.

Parameter
NameDescription
var array<Google\Cloud\Run\V2\Condition>
Returns
TypeDescription
$this

getObservedGeneration

Output only. The generation of this Execution. See comments in reconciling for additional information on reconciliation process in Cloud Run.

Returns
TypeDescription
int|string

setObservedGeneration

Output only. The generation of this Execution. See comments in reconciling for additional information on reconciliation process in Cloud Run.

Parameter
NameDescription
var int|string
Returns
TypeDescription
$this

getRunningCount

Output only. The number of actively running tasks.

Returns
TypeDescription
int

setRunningCount

Output only. The number of actively running tasks.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getSucceededCount

Output only. The number of tasks which reached phase Succeeded.

Returns
TypeDescription
int

setSucceededCount

Output only. The number of tasks which reached phase Succeeded.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getFailedCount

Output only. The number of tasks which reached phase Failed.

Returns
TypeDescription
int

setFailedCount

Output only. The number of tasks which reached phase Failed.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getCancelledCount

Output only. The number of tasks which reached phase Cancelled.

Returns
TypeDescription
int

setCancelledCount

Output only. The number of tasks which reached phase Cancelled.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getRetriedCount

Output only. The number of tasks which have retried at least once.

Returns
TypeDescription
int

setRetriedCount

Output only. The number of tasks which have retried at least once.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getLogUri

Output only. URI where logs for this execution can be found in Cloud Console.

Returns
TypeDescription
string

setLogUri

Output only. URI where logs for this execution can be found in Cloud Console.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getSatisfiesPzs

Output only. Reserved for future use.

Returns
TypeDescription
bool

setSatisfiesPzs

Output only. Reserved for future use.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getEtag

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

Returns
TypeDescription
string

setEtag

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

Parameter
NameDescription
var string
Returns
TypeDescription
$this