Using the Perl API
Perl API reference
IntroductionACL managementApplication dependencyApplicationsApplication tier Artifact managementCatalogsChange historyCI build detailCI configurationCI jobsComponentsCredential managementCustom filtersDatabase configurationData retentionCloudBees AnalyticsDirectory 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
Perl API response and element glossary
Using the Groovy API
IntroductionExamplesTroubleshooting
Groovy API reference
IntroductionaccesstokenaclaclentryactualparameteractualparametersapplicationapplicationdependencyapplicationservicemappingapplicationtierarchiveconnectorartifactartifactversioncatalogcatalogitemcatalogitemruncibuildcibuilddetailciconfigurationcieventclustercomponentcontainercredentialcredentialproviderdashboarddashboardcolumndataretentionpolicydeployerapplicationdeployerconfigurationdeployerservicedeploymenthistoryitemdevopsinsightdatasourcedirectoryprovideremailconfigemailnotifierentitychangeenvironmentenvironmentinventoryitemenvironmentmapenvironmenttemplateenvironmenttemplatetierenvironmenttemplatetiermapenvironmenttemplatetiermappingenvironmenttierenvironmentvariableenvtempltierresourcetemplmappingeventsubscriptionflowruntimeformaloutputparameterformalparametergategatewaygrouphookjobjobstepkerberoskeytablicensemicroservicemicroservicemappingnoteobjectoutputparameterpersonapersonacategorypersonapagepipelinepluginpluginconfigurationportprocedureprocedurestepprocessprocessdependencyprocessstepprojectpropertyreleasereportreportingfilterreportobjectassociationreportobjectattributereportobjecttyperepositoryreservationresourceresourcepoolresourcetemplateresourceusageretrievedartifactsrollingdeployphaserundiscoverysamlidentityprovidersamlserviceproviderschedulesearchfilterserverserversettingserversettingcategoryserviceaccountserviceserviceclustermappingservicedependencyservicemapdetailsessionsnapshotstagestatestatedefinitiontagtasktiermaptiermappingtransitiontransitiondefinitiontriggertriggererrordetailuseruseremailutilityresourcewaitdependencywebhookresultwidgetwidgetfilteroverrideworkflowworkflowdefinitionworkitemworkspacezoneArgument models

EnvironmentInventoryItem

4 minute readReference

createEnvironmentInventoryItem

Creates a new environment inventory item.

Arguments

Argument Name Type Description

projectName

String

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

environmentName

String

The name of the environment. (Required)

applicationName

String

Application that owns the inventory item

applicationTierName

String

Name of the application tier

artifactName

String

Artifact name for the inventory item

artifactSource

String

Source of the artifact

artifactUrl

String

Url of the artifact

artifactVersion

String

Artifact version for the inventory item

clusterName

String

Cluster where the item is installed

componentName

String

Component that owns the inventory item

containerName

String

Deprecated: Deprecated due to microservice model changes Container that owns the inventory item

description

String

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

environmentProjectName

String

Name for the project to which the environment or environment template belongs to.

microserviceName

String

Service that owns the inventory item

resourceName

String

Resource where the item is installed

serviceName

String

Deprecated: Deprecated due to microservice model changes Service that owns the inventory item

status

String

Inventory deployment status

Usage

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


ElectricFlow ef = new ElectricFlow()

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

deleteEnvironmentInventoryItem

Delete an inventory item

Arguments

Argument Name Type Description

projectName

String

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

environmentName

String

The name of the environment. (Required)

serviceName

String

Deprecated: Deprecated due to microservice model changes Service that owns the inventory item

containerName

String

Deprecated: Deprecated due to microservice model changes Container that owns the inventory item

applicationName

String

Application that owns the inventory item

artifactName

String

Artifact name for the inventory item

clusterName

String

Cluster where the item is installed

componentName

String

Component that owns the inventory item

environmentProjectName

String

Name for the project to which the environment or environment template belongs to.

microserviceName

String

Service that owns the inventory item

resourceName

String

Resource where the item is installed

Usage

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


ElectricFlow ef = new ElectricFlow()

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

getEnvironmentInventory

Retrieve a per-component or microservice grouped list of inventory items

Arguments

Argument Name Type Description

projectName

String

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

environmentName

String

The name of the environment. (Required)

serviceName

String

Deprecated: Deprecated due to microservice model changes The name of the service.

applicationEntityRevisionId

String

Revisionid of the versioned object

applicationName

String

The name of the application.

environmentProjectName

String

Name for the project to which the environment or environment template belongs to.

serviceEntityRevisionId

String

Deprecated: Deprecated due to microservice model changes Revisionid of the versioned object

Usage

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


ElectricFlow ef = new ElectricFlow()

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

getEnvironmentInventoryItem

Retrieve an inventory item

Arguments

Argument Name Type Description

projectName

String

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

environmentName

String

The name of the environment. (Required)

serviceName

String

Deprecated: Deprecated due to microservice model changes Service that owns the inventory item

containerName

String

Deprecated: Deprecated due to microservice model changes Container that owns the inventory item

applicationName

String

Application that owns the inventory item

artifactName

String

Artifact name for the inventory item

clusterName

String

Cluster where the item is installed

componentName

String

Component that owns the inventory item

environmentProjectName

String

Name for the project to which the environment or environment template belongs to.

includeResourceDetails

Boolean

True to include resource details (default is false)

microserviceName

String

Service that owns the inventory item

resourceName

String

Resource where the item is installed

Usage

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


ElectricFlow ef = new ElectricFlow()

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

getEnvironmentInventoryItems

Retrieve all inventory items for a given environment

Arguments

Argument Name Type Description

projectName

String

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

environmentName

String

The name of the environment. (Required)

includeResourceDetails

Boolean

True to include resource details (default is false)

Usage

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


ElectricFlow ef = new ElectricFlow()

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

modifyEnvironmentInventoryItem

Modifies an existing environment inventory item.

Arguments

Argument Name Type Description

projectName

String

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

environmentName

String

The name of the environment. (Required)

serviceName

String

Deprecated: Deprecated due to microservice model changes Service that owns the inventory item

containerName

String

Deprecated: Deprecated due to microservice model changes Container that owns the inventory item

applicationName

String

Application that owns the inventory item

applicationTierName

String

Name of the application tier

artifactName

String

Artifact name for the inventory item

artifactSource

String

Source of the artifact

artifactUrl

String

Url of the artifact

artifactVersion

String

Artifact version for the inventory item

clusterName

String

Cluster where the item is installed

componentName

String

Component that owns the inventory item

description

String

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

environmentProjectName

String

Name for the project to which the environment or environment template belongs to.

microserviceName

String

Service that owns the inventory item

resourceName

String

Resource where the item is installed

status

String

Inventory deployment status

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.modifyEnvironmentInventoryItem(
                projectName: 'test-projectName',
                environmentName: 'test-environmentName',
                /* optional arguments */)
environment
environmentmap