Groovy API reference

Process

4 minute readReference

createProcess

Creates a new process for an application or component.

Arguments

Argument NameTypeDescription

projectName

String

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

processName

String

The name of the process. (Required)

componentName

String

The name of the component, if the process is owned by a component.

applicationName

String

The name of the application, if the process is owned by an application.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

credentialName

String

The name of a credential to attach to this process.

description

String

Comment text describing this object that is not interpreted at all by CloudBees CD/RO.

exclusiveEnvironment

Boolean

True if environment is exclusive to the application or service process.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

processType

String

Defines type of action performed by the process

smartUndeployEnabled

Boolean

True if smart deploy should be enabled for the undeploy component process

timeLimit

String

Maximum amount of time the step can execute; abort if it exceeds this time.

timeLimitUnits

String

Units for step time limit: seconds, minutes, or hours.

workingDirectory

String

Working directory in which to execute the command for this process. A relative name is interpreted relative to the root directory for the job’s workspace.

workspaceName

String

The name of the default workspace for this process.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.createProcess(
                projectName: 'test-projectName',
                processName: 'test-processName'
                /* optional arguments */)

deleteProcess

Deletes an application or component process.

Arguments

Argument NameTypeDescription

projectName

String

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

processName

String

The name of the process. (Required)

componentName

String

The name of the component, if the process is owned by a component.

applicationName

String

The name of the application, if the process is owned by an application.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.deleteProcess(
                projectName: 'test-projectName',
                processName: 'test-processName'
                /* optional arguments */)

getProcess

Get an application or component process.

Arguments

Argument NameTypeDescription

projectName

String

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

processName

String

The name of the process. (Required)

componentName

String

The name of the component, if the process is owned by a component.

applicationEntityRevisionId

String

Revisionid of the versioned object

applicationName

String

The name of the application, if the process is owned by an application.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getProcess(
                projectName: 'test-projectName',
                processName: 'test-processName'
                /* optional arguments */)

getProcesses

Retrieve all processes in an application or component.

Arguments

Argument NameTypeDescription

projectName

String

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

componentName

String

The name of the component, if the process is owned by a component.

applicationEntityRevisionId

String

Revisionid of the versioned object

applicationName

String

The name of the application, if the process is owned by an application.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getProcesses(
                projectName: 'test-projectName',
                /* optional arguments */)

modifyProcess

Modifies an existing process.

Arguments

Argument NameTypeDescription

projectName

String

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

processName

String

The name of the process. (Required)

componentName

String

The name of the component, if the process is owned by a component.

applicationName

String

The name of the application, if the process is owned by an application.

componentApplicationName

String

If specified, the component is scoped to this application not the project.

credentialName

String

The name of a credential to attach to this process.

description

String

Comment text describing this object that is not interpreted at all by CloudBees CD/RO.

exclusiveEnvironment

Boolean

True if environment is exclusive to the application or service process.

microserviceApplicationName

String

If specified, the microservice is scoped to an application.

microserviceName

String

The name of the microservice, if the process is owned by a microservice.

newName

String

New name for an existing object that is being renamed.

processType

String

Defines type of action performed by the process

smartUndeployEnabled

Boolean

True if smart deploy should be enabled for the undeploy component process

timeLimit

String

Maximum amount of time the step can execute; abort if it exceeds this time.

timeLimitUnits

String

Units for step time limit: seconds, minutes, or hours.

workingDirectory

String

Working directory in which to execute the command for this process. A relative name is interpreted relative to the root directory for the job’s workspace.

workspaceName

String

The name of the default workspace for this process.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.modifyProcess(
                projectName: 'test-projectName',
                processName: 'test-processName'
                /* optional arguments */)