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

Applications Commands

3 minute readReference

createApplication

Creates a new application for a project.

You must specify the projectName and applicationName.

Arguments Descriptions

projectName

Name of the project. This name must be unique among all projects.

Argument Type: String

Argument Type: String

applicationName

Name of the application that must be unique among all projects.

Argument Type: String

description

(Optional) Comment text describing this object that is not interpreted at all by CloudBees Flow.

Argument Type: String

Positional arguments

projectName, applicationName

Response

Returns an application element.

ec-perl

syntax: $<object>->createApplication(<projectName>, <applicationName>, {<optionals>});

Example

$ec->createApplication("Default", "Deploy", {description => "QA testing"});

ectool

syntax: ectool createApplication <projectName> <applicationName> [optionals]

Example

ectool createApplication "Default" "Deploy" --description "QA testing"

Back to top

deleteApplication

Deletes an application.

You must specify the projectName and applicationName.

Arguments Descriptions

projectName

Name of the project. This name must be unique among all projects.

Argument Type: String

Argument Type: String

applicationName

Name of the application that must be unique among all projects.

Argument Type: String

foreground

(Optional) < Boolean flag— 0|1|true|false >

If set to 1 or true, the object in the foreground is deleted. The default is 0 or false, which deletes the object in the background.

Argument Type: Boolean

retainInventory

(Optional) < Boolean flag— 0|1|true|false >

Whether to delete the environment inventory when this application is deleted.

  • If set to 1 or true, retain the environment inventory. If set 0 or false, delete the environment inventory. (Default)

Argument Type: Boolean

Positional arguments

projectName, applicationName

Response

None or a status OK message.

ec-perl

syntax: $<object>->deleteApplication (<projectName>, <applicationName>);

Example

$ec->deleteApplication ("Default", "Undeploy");

ectool

syntax: ectool deleteApplication <projectName> <applicationName>

Example

ectool deleteApplication "Default" "Undeploy"

Back to top

getApplication

Retrieves an application by name.

You must specify the projectName and applicationName.

Arguments Descriptions

projectName

Name of the project. This name must be unique among all projects.

Argument Type: String

Argument Type: String

applicationName

Name of the application that must be unique among all projects.

Argument Type: String

applicationEntityRevisionId

(Optional) The revision ID of the versioned object.

Argument type: UUID

Positional arguments

projectName, applicationName

Response

Retrieves the specified application element.

ec-perl

syntax: $<object>->getApplication(<projectName>, <applicationName>, {<optionals>});

Example

$ec->getApplication("Default", "Deploy", {applicationEntityRevisionId => "4fa765dd-73f1-11e3-b67e-b0a420524153"});

ectool

syntax: ectool getApplication <projectName> <applicationName> [optionals]

Example

ectool getApplication "Default" "Deploy" --applicationEntityRevisionId 4fa765dd-73f1-11e3-b67e-b0a420524153

Back to top

getApplications

Retrieves all applications in a project.

You must specify the projectName.

Arguments Descriptions

projectName

Name of the project. This name must be unique among all projects.

Argument Type: String

Argument Type: String

includeEntityRevisions

(Optional) < Boolean flag— 0|1|true|false >

If set to 1 or true, the search results include the revisions of application.

Argument type: Boolean

referenceComponentName

(Optional) Name of the master component.

Argument Type: String

referenceComponentProject

(Optional) Project to which the master component belongs.

Argument Type: String

Positional arguments

projectName

Response

Retrieves zero or more application elements.

ec-perl

syntax: $<object>->getApplications(<projectName>, {<optionals>});

Example

$ec->getApplications("Default", {referenceComponentProject => "Financial Summaries"});

ectool

syntax: ectool getApplications <projectName> [optionals]

Example

ectool getApplications "Default" --referenceComponentProject "Financial Summaries"

Back to top

modifyApplication

Modifies an existing application.

You must specify the projectName and the applicationName.

Arguments Descriptions

projectName

Name of the project. This name must be unique among all projects.

Argument Type: String

Argument Type: String

applicationName

Name of the application that must be unique within the project.

Argument Type: String

description

(Optional) Comment text describing this object; not interpreted at all by CloudBees Flow.

Argument Type: String

newName

(Optional) New name for an existing object that is being renamed.

Argument Type: String

Positional arguments

projectName, applicationName

Response

Returns a modified application element.

ec-perl

syntax: $<object>->modifyApplication(<projectName>, <applicationName>, {<optionals>});

Example

$ec->modifyApplication("Default", "Deploy config", {newName=> "Deploy WAR file", description => "Pet store website"});

ectool

syntax: ectool modifyApplication <projectName> <applicationName> [optionals]

Example

ectool modifyApplication "Default" "Deploy config" --newName "Deploy WAR file" --description "Pet Store website"

Back to top

Application Dependency
Application Tier