Skip to main content

automation_runs

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

Overview

Nameautomation_runs
TypeResource
Idgoogle.clouddeploy.automation_runs

Fields

NameDatatypeDescription
namestringOutput only. Name of the AutomationRun. Format is projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}/automationRuns/{automation_run}.
advanceRolloutOperationobjectContains the information of an automated advance-rollout operation.
automationIdstringOutput only. The ID of the automation that initiated the operation.
automationSnapshotobjectAn Automation resource in the Cloud Deploy API. An Automation enables the automation of manually driven actions for a Delivery Pipeline, which includes Release promotion among Targets, Rollout repair and Rollout deployment strategy advancement. The intention of Automation is to reduce manual intervention in the continuous delivery process.
createTimestringOutput only. Time at which the AutomationRun was created.
etagstringOutput only. The weak etag of the AutomationRun resource. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
expireTimestringOutput only. Time the AutomationRun expires. An AutomationRun expires after 14 days from its creation date.
promoteReleaseOperationobjectContains the information of an automated promote-release operation.
repairRolloutOperationobjectContains the information for an automated repair rollout operation.
ruleIdstringOutput only. The ID of the automation rule that initiated the operation.
serviceAccountstringOutput only. Email address of the user-managed IAM service account that performs the operations against Cloud Deploy resources.
statestringOutput only. Current state of the AutomationRun.
stateDescriptionstringOutput only. Explains the current state of the AutomationRun. Present only when an explanation is needed.
targetIdstringOutput only. The ID of the target that represents the promotion stage that initiates the AutomationRun. The value of this field is the last segment of a target name.
updateTimestringOutput only. Time at which the automationRun was updated.
waitUntilTimestringOutput only. Earliest time the AutomationRun will attempt to resume. Wait-time is configured by wait in automation rule.

Methods

NameAccessible byRequired ParamsDescription
getSELECTautomationRunsId, deliveryPipelinesId, locationsId, projectsIdGets details of a single AutomationRun.
listSELECTdeliveryPipelinesId, locationsId, projectsIdLists AutomationRuns in a given project and location.
cancelEXECautomationRunsId, deliveryPipelinesId, locationsId, projectsIdCancels an AutomationRun. The state of the AutomationRun after cancelling is CANCELLED. CancelAutomationRun can be called on AutomationRun in the state IN_PROGRESS and PENDING; AutomationRun in a different state returns an FAILED_PRECONDITION error.

SELECT examples

Lists AutomationRuns in a given project and location.

SELECT
name,
advanceRolloutOperation,
automationId,
automationSnapshot,
createTime,
etag,
expireTime,
promoteReleaseOperation,
repairRolloutOperation,
ruleId,
serviceAccount,
state,
stateDescription,
targetId,
updateTime,
waitUntilTime
FROM google.clouddeploy.automation_runs
WHERE deliveryPipelinesId = '{{ deliveryPipelinesId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';