IntroductionRoadmap to CloudBees Flow APIsUsing the CloudBees Flow Perl APICloudBees Flow Perl API Response and Element GlossaryUsing the CloudBees Flow RESTful APIUsing the Flow DSLUsing the CloudBees Flow Groovy APIUsing JRubyCloudBees Flow Error MessagesCloudBees Flow Perl API Response and Element Glossary
IntroductionACL ManagementApplication DependencyApplicationsApplication Tier Artifact ManagementCatalogsChange HistoryComponentsCredential ManagementCustom FiltersDatabase ConfigurationData RetentionDevOps InsightDirectory Provider ManagementDynamic EnvironmentsEmail Configuration ManagementEmail Notifier ManagementEnvironmentEnvironment TierGateway and Zone ManagementInstalling or Upgrading Remote AgentsJob ManagementMicroservicesObject TagsParameter ManagementPersonasPipelines and ReleasesPlugin ManagementProcedure ManagementProcessProcess DependencyProcess StepProject ManagementProperty ManagementResource ManagementRolling DeploySchedule ManagementServer ManagementSingle Sign-OnSnapshotsTier MapUser and Group ManagementWait DependenciesWebhhook ManagementWorkflow Definition ManagementWorkflow ManagementWork ItemsWorkspace ManagementMiscellaneous Management
IntroductionExamples
Introductionaclaclentryactualparameteractualparametersappdepapplicationappservicemappingapptierarchiveconnectorartifactartifactversioncatalogcatalogitemclustercomponentcontainercredentialdashboarddashboardcolumndataretentiondeployerappdeployerconfdeployerservicedeployhistorydirproviderdoisdatasourceemailconfigemailnotifierentitychangeenvinvenvironmentenvmapenvtemeplateenvtemptierenvtemptiermapenvtemptiermappingenvtemptierresourcemappingenvtierenvvareventsubflowruntimeformaloutparamformalparamgategatewaygrouphookjobjobstepkerberoskeytablicensenoteobjectoutputparampersonapersonacatpersonapagepipelinepipelinerunnamepluginportprocdependprocedureprocessprocstepprojectpropertyreleasereportreportfilterreportobjassocreportobjattrreportobjtyperepositoryreservationresourceresourcepoolresourcetemplateresourceusageretrievedartrollingrundiscoverysamlidentitysamlserviceschedulesearchfilterserverserviceserviceacctserviceclusterservicedepservicemapsessionsnapshotstagestatestatedeftagtasktiermaptiermappingtransdeftransitionuserutilitywaitdependwidgetwidgetfilteroverrideworkdefworkflowworkitemworkspacezone
Groovy API argument models

FlowRuntime commands

5 minute readReference

abortPipelineRun

Abort a pipeline run.

Arguments

Argument Name Type Description

flowRuntimeId

String

The id of the flow runtime

flowRuntimeName

String

The name of the flow runtime

force

Boolean

If true running tasks are force aborted.

projectName

String

The name of the project

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.abortPipelineRun(
                /* optional arguments */)
▼

completeManualTask

Complete manual task operation.

Arguments

Argument Name Type Description

flowRuntimeId

String

The id of the flow runtime (Required)

stageName

String

The name of the stage (Required)

taskName

String

The name of the task (Required)

gateType

String

The type of the gate.

action

String

The type of action to be taken on the manual process step or manual task or gate task

actualParameters

actualParameter array

Actual parameters passed to an invoked subprocedure

evidence

String

Evidence provided while taking an action on the manual process step or manual task or gate task

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.completeManualTask(
                flowRuntimeId: 'test-flowRuntimeId',
                stageName: 'test-stageName',
                taskName: 'test-taskName'
                /* optional arguments */)
▼

completeRuntimeWaitDependency

Complete a wait dependency for a stage or task

Arguments

Argument Name Type Description

flowRuntimeId

String

The UUID of the invoking flowRuntime.

projectName

String

The name for the project that contains the wait dependency.

pipelineName

String

The name of the pipeline

stageName

String

The name of the stage

runtimeWaitDependencyName

String

The name of the runtimeWaitDependency.

dependentFlowRuntimeId

String

The UUID of the dependent flowRuntime.

dependentGateType

String

The type of dependent gate.

dependentPipelineName

String

The name of the dependent pipeline

dependentProjectName

String

The name of the dependent project

dependentReleaseName

String

The name of the dependent release

dependentStageName

String

The name of the dependent stage

dependentTaskName

String

The name of the dependent task

gateType

String

The type of gate.

releaseName

String

The name of the release

taskName

String

The name of the task

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.completeRuntimeWaitDependency(
                /* optional arguments */)
▼

deletePipelineRun

Deletes a pipeline runtime

Arguments

Argument Name Type Description

projectName

String

The name of the project

flowRuntimeId

String

The id of the flow runtime

flowRuntimeName

String

The name of the flow runtime

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.deletePipelineRun(
                /* optional arguments */)
▼

getPipelineRuntimeDetails

Get pipeline runtime details.

Arguments

Argument Name Type Description

flowRuntimeIds

String array

List of pipeline flowruntime ids of interest.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getPipelineRuntimeDetails(
                /* optional arguments */)
▼

getPipelineRuntimes

Return pipe line runs.

Arguments

Argument Name Type Description

projectName

String

The name of the project

pipelineName

String

The name of the pipeline

filters

filter array

Filters

firstResult

Integer

Result pagination: the first row to return.

flowRuntimeId

String

The id of the flow runtime

flowRuntimeName

String

The name of the flow runtime

maxResults

Integer

Result pagination: the number of rows to return.

releaseId

String

The id of the release

sortKey

String

How to sort the results.

sortOrder

String

Which order to sort in

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getPipelineRuntimes(
                /* optional arguments */)
▼

getReleaseTimelineDetails

Get planned versus actual time details for a release.

Arguments

Argument Name Type Description

projectName

String

The name for the project that must be unique among all projects. (Required)

releaseName

String

The name of the release (Required)

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getReleaseTimelineDetails(
                projectName: 'test-projectName',
                releaseName: 'test-releaseName')
▼

getRunHierarchy

Get pipeline or release run hierarchy

Arguments

Argument Name Type Description

flowRuntimeId

String

The id of the flow runtime

filters

filter array

Filters

mode

String

The mode of portfolio view

pipelineName

String

The name of the pipeline

projectName

String

The name of the project

releaseName

String

The name of the release

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getRunHierarchy(
                /* optional arguments */)
▼

getRuntimeWaitDependencies

Get all pipeline dependencies on a pipeline run.

Arguments

Argument Name Type Description

flowRuntimeId

String

The UUID of the invoking flowRuntime. (Required)

stageName

String

The name of the stage

gateType

String

The type of gate.

taskName

String

The name of the task

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getRuntimeWaitDependencies(
                flowRuntimeId: 'test-flowRuntimeId',
                /* optional arguments */)
▼

restartPipelineRun

Restart a pipeline run.

Arguments

Argument Name Type Description

flowRuntimeId

String

The id of the flow runtime

actualParameters

actualParameter array

The list of actual parameters.

comment

String

Comment provided while restarting pipeline run which has completed with error.

flowRuntimeName

String

The name of the flow runtime

gateType

String

The type of the gate.

projectName

String

The name of the project

stageName

String

The name of a stage from which to restart a pipeline.

taskName

String

The name of a high-level task in the last active stage from which to restart a pipeline.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.restartPipelineRun(
                /* optional arguments */)
▼

retryTask

Continue to run pipeline flow runtime if it there are tasks waiting on error.

Arguments

Argument Name Type Description

flowRuntimeId

String

The id of the flow runtime (Required)

stageName

String

The name of the stage (Required)

taskName

String

The name of the task (Required)

action

String

Action to execute: rerun (default), skip or fail the task

comment

String

Comment provided while retry an action on the manual process step or manual task or gate task

gateType

String

The type of the gate.

subapplication

String

The name of the sub application.

subproject

String

The name of the project that contains the sub application

subservice

String

The name of the sub service.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.retryTask(
                flowRuntimeId: 'test-flowRuntimeId',
                stageName: 'test-stageName',
                taskName: 'test-taskName'
                /* optional arguments */)
▼

runFutureTask

run a task out of order - in a stage or gate that hasn’t started yet.

Arguments

Argument Name Type Description

flowRuntimeId

String

The id of the flow runtime (Required)

stageName

String

The name of the stage (Required)

taskName

String

The name of the task (Required)

gateType

String

The type of the gate.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.runFutureTask(
                flowRuntimeId: 'test-flowRuntimeId',
                stageName: 'test-stageName',
                taskName: 'test-taskName'
                /* optional arguments */)
▼

runPipeline

Run the specified pipeline, return the flowRuntimeId.

Arguments

Argument Name Type Description

pipelineName

String

The name of the pipeline (Required)

projectName

String

The name for the project that must be unique among all projects. (Required)

actualParameters

actualParameter array

The list of actual parameters.

credentials

credential array

Credentials to be used in the state.

priority

String

The priority of jobs launched by the pipeline.

releaseName

String

The name of the release

scheduleName

String

Name for the schedule; must be unique among all schedules for the project.

stagesToRun

String array

One or more stages to run in a pipeline.

startingStage

String

The name of the starting stage.

webhookData

String

The webhook data to be set on the pipeline/release/procedure run.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.apis.model.*


ElectricFlow ef = new ElectricFlow()

def result = ef.runPipeline(
                pipelineName: 'test-pipelineName',
                projectName: 'test-projectName'
                /* optional arguments */)
▼
eventsub
formaloutparam