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

Microservices

14 minute readReference

createMicroservice

Creates a new microservice for a project or application.

You must specify the projectName and microserviceName.

Arguments Descriptions

projectName

Project containing the microservice application.

Argument Type: String

microserviceName

Name of the microservice.

Argument Type: String

addDeployProcess

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

Whether a deploy process is to be generated for the microservice. Defaults to true or 1.

Argument Type: Boolean

applicationName

Name of the microservice application.

Argument Type: String

definitionSource

The name representing the definition source, git or helm_repository.

Argument Type: String

definitionSourceParameter

Parameters specific to definitionSource. Format: var1=val1 [var2=val2 …​]

Argument Type: PropertySheet

definitionType

The name representing the definition type. The only supported type is helm.

Argument Type: String

deployParameter

Actual parameters for the plugin procedure to use to fetch the Helm chart. Format: var1=val1 [var2=val2 …​]

Argument Type: PropertySheet

description

User-supplied description.

Argument Type: String

Positional arguments

projectName microserviceName

Response

Returns a microservice element.

ec-perl

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

Example

$ec->createMicroservice({
	projectName => "Default",
	microserviceName => "myMicroservice" ,
	applicationName	 => "myApp",
	definitionType	 => "helm",
	definitionSource => "git",
	definitionSourceParameter =>[
		{
			definitionSourceParameterName => "config",
			value => "test"
		},{
			definitionSourceParameterName => "branch",
			value => "main"
		},{
			definitionSourceParameterName => "repoUrl",
			value => "https://your_repo_url"
		}],
	deployParameter =>[
		{
			deployParameterName => "releaseName",
			value => "test"
		},{
			deployParameterName => "chart",
			value => "chart/test"
		}]
});

ectool

syntax: ectool createMicroservice <projectName> <microserviceName> [optionals]

Example

ectool createMicroservice "Default" "myMicroservice"
		--applicationName "myApp"
		--definitionType "helm"
		--definitionSource "git"
		--definitionSourceParameter config="test" branch="main" repoUrl="https://your_repo_url"
		--deployParameter releaseName="test" chart="chart/test"

Back to top

deleteMicroservice

Deletes a microservice application.

You must specify the projectName and microserviceName.

Arguments Descriptions

projectName

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

Argument Type: String

microserviceName

Name of the microservice to delete.

Argument Type: String

applicationName

Name of the microservice application.

Argument Type: String

Positional arguments

projectName, microserviceName

Response

None or a status OK message.

ec-perl

syntax: $<object>->deleteMicroservice (<projectName>, <microserviceName>);

Example

$ec->deleteMicroservice ({
	projectName => "Default",
	microserviceName => "myMicroservice" ,
	applicationName	 => "myApp"
});

ectool

syntax: ectool deleteMicroservice <projectName> <microserviceName>

Example

ectool deleteMicroservice "Default" "myMicroservice"
		--applicationName "myApp"

Back to top

getMicroservice

Retrieves a microservice by name.

You must specify the projectName and microserviceName.

Arguments Descriptions

projectName

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

Argument Type: String

microserviceName

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

Argument Type: String

applicationName

The name of an application that this service is scoped to.

Argument type: String

Positional arguments

projectName, microserviceName

Response

Retrieves the specified microservice element.

ec-perl

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

Example

$ec->getMicroservice({
	projectName => "Default",
	microserviceName => "myMicroservice" ,
	applicationName	 => "myApp"
});

ectool

syntax: ectool getMicroservice <projectName> <microserviceName> [optionals]

Example

ectool getMicroservice "Default" "myMicroservice"
		--applicationName "myApp"

Back to top

getMicroservices

Retrieves all microservices in a project or application.

You must specify the projectName.

Arguments Descriptions

projectName

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

Argument Type: String

applicationName

The name of an application that this service is scoped to.

Argument Type: String

Positional arguments

projectName

Response

Retrieves zero or more microservice elements.

ec-perl

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

Example

$ec->getMicroservices({
	projectName => "Default",
	applicationName	 => "myApp"
});

ectool

syntax: ectool getMicroservices <projectName> [optionals]

Example

ectool getMicroservices "Default" --applicationName "myApp"

Back to top

modifyMicroservice

Modifies an existing microservice.

You must specify the projectName and the microserviceName.

Arguments Descriptions

projectName

Project containing the microservice application.

Argument Type: String

microserviceName

Name of the microservice.

Argument Type: String

addDeployProcess

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

Whether a deploy process is to be generated for the microservice. Defaults to true or 1.

Argument Type: Boolean

applicationName

Name of the microservice application.

Argument Type: String

definitionSource

The name representing the definition source, git or helm_repository.

Argument Type: String

definitionSourceParameter

Parameters specific to definitionSource. Format: var1=val1 [var2=val2 …​]

Argument Type: PropertySheet

definitionType

The name representing the definition source. The only supported type is helm.

Argument Type: String

deployParameter

Actual parameters for the plugin procedure to use to fetch the Helm chart. Format: var1=val1 [var2=val2 …​]

Argument Type: PropertySheet

description

User-supplied description.

Argument Type: String

newName

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

Argument Type: String

Positional arguments

projectName, microserviceName

Response

Returns the modified microservice element.

ec-perl

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

Example

$ec->modifyMicroservice({
	projectName => "Default",
	microserviceName => "myMicroservice" ,
	applicationName	 => "myApp",
	newName => "Deploy new microservice",
	description => "Pet store website"
 });

ectool

syntax: ectool modifyMicroservice <projectName> <microserviceName> [optionals]

Example

ectool modifyMicroservice "Default" "myMicroservice" --applicationName "myApp" --newName "Deploy new microservice" --description "Pet Store website"

Back to top

createMicroserviceMapping

Creates a new mapping between a microservice and an environment cluster.

You must specify the projectName.

Arguments Descriptions

projectName

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

Argument Type: String

applicationName

(Optional) The name of the application that contains the microservice.

Argument type: String

clusterName

(Optional) The name of the environment that contains the cluster.

Argument type: String

clusterProjectName

(Optional) The name of the cluster’s environment project if it is different from the application.

Argument type: String

environmentName

(Optional) The name of the environment that contains the cluster.

Argument type: String

microserviceName

(Optional) The name of the microservice.

Argument type: String

microserviceMappingName

(Optional) The name of the microservice map.

Argument type: String

tierMapName

(Optional) The name of the tier map.

Argument type: String

Positional arguments

projectName applicationName

Response

Returns the flowRuntimeId object.

ec-perl

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

Example

$ec->createMicroserviceMapping("service_proj1", {environmentName => "qe env name",microserviceName => "qe service 1", clusterName => "qe cluster", tierMapName => "map", clusterProjectName => "cluster_proj"});

ectool

syntax: ectool createMicroserviceMapping <projectName> [optionals]

Example

ectool createMicroserviceMapping "service_proj1" --environmentName "qe env" --microserviceName "qe service 1" --clusterName "qe cluster" --tierMapName "map"  --clusterProjectName "cluster_proj"

Back to top

deleteMicroserviceMapping

Deletes a microservice cluster mapping.

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

microserviceMappingName

(Optional) The name of the service cluster mapping.

Argument Type: String

applicationName

(Optional) The name of the application which contains the service.

Argument Type: String

clusterName

(Optional) The name of the environment cluster.

Argument Type: String

clusterProjectName

(Optional) The name of the project which contains the cluster.

Argument Type: String

environmentName

(Optional) The name of the environment which contains the cluster.

Argument Type: String

microserviceName

(Optional) The name of the independent service.

Argument Type: String

tierMapName

(Optional) The name of the tier map. If not provided, the application name and environment name are used to resolve tierMap.

Argument Type: String

Positional arguments

projectName

Response

None or a status OK message.

ec-perl

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

Example

$ec->deleteMicroserviceMapping("qe proj service" "myMap" {environmentName => "qe env",microserviceName => "qe service1", clusterName => "qe cluster1", clusterProjectName => "qe proj cluster"});

ectool

syntax: ectool deleteMicroserviceMapping <projectName> <microserviceMappingName> [optionals]

Example

ectool deleteMicroserviceMapping "qe proj service" "myMap" --environmentName "qe env" --microserviceName "qe service1" --clusterName "qe cluster1"

Back to top modifyucreateMicroserviceMapping]] modifyMicroserviceMapping

Creates a new mapping between a microservice and an environment cluster.

You must specify the projectName.

Arguments Descriptions

projectName

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

Argument Type: String

applicationName

(Optional) The name of the application that contains the microservice.

Argument type: String

clusterName

(Optional) The name of the environment that contains the cluster.

Argument type: String

clusterProjectName

(Optional) The name of the cluster’s environment project if it is different from the application.

Argument type: String

environmentName

(Optional) The name of the environment that contains the cluster.

Argument type: String

microserviceName

(Optional) The name of the microservice.

Argument type: String

microserviceMappingName

(Optional) The name of the microservice map.

Argument type: String

tierMapName

(Optional) The name of the tier map.

Argument type: String

environmentName

(Optional) The name of the environment that contains the cluster.

Argument type: String

newName

The new name of theos microserviceMapping object.

Argument type: String

Positional arguments

projectName

Response

Returns the flowRuntimeId object.

ec-perl

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

Example

$ec->modifyMicroserviceMapping("service_proj1", {environmentName => "qe env name",microserviceName => "qe service 1", clusterName => "qe cluster", tierMapName => "map", clusterProjectName => "cluster_proj"});

ectool

syntax: ectool createMicroserviceMapping <projectName> [optionals]

Example

ectool modifyMicroserviceMapping "service_proj1" --environmentName "qe env" --microserviceName "qe service 1" --clusterName "qe cluster" --tierMapName "map"  --clusterProjectName "cluster_proj"

Back to top

createCluster

Creates a new cluster configuration object for a microservice application.

You must specify the projectName and clusterName.

Arguments Descriptions

projectName

Project containing the cluster application.

Argument Type: String

clusterName

Name of the cluster.

Argument Type: String

environmentName

Name of the environment into which cluster is placed.

Argument Type: String

pluginKey

The name representing the definition source. Use helm.

Argument Type: String

definitionParameter

Actual parameters related to the procedure capturing the cluster definition. For example, configuration, namespace, and so on.

Argument Type: String`

Positional arguments

projectName clusterName

Response

Returns a cluster element.

ec-perl

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

Example

$ec->createCluster("Default", "MyCluster");

ectool

syntax: ectool createCluster <projectName> <clusterName> [optionals]

Example

ectool createMicroservice "Default" "MyCluster"

Back to top

modifyCluster

Modify an existing cluster configuration object for a microservice application.

You must specify the projectName and clusterName.

Arguments Descriptions

projectName

Project containing the cluster application.

Argument Type: String

clusterName

Name of the cluster.

Argument Type: String

environmentName

Name of the environment into which cluster is placed.

Argument Type: String

pluginKey

The name representing the definition source. The only supported type is helm.

Argument Type: String

definitionParameter

Actual parameters related to the procedure capturing the cluster definition.

Argument Type: String`

newName

The new name of theos microserviceMapping object.

Argument type: String

Positional arguments

projectName clusterName

Response

Returns a cluster element.

ec-perl

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

Example

$ec->modifyCluster("Default", "MyCluster", newName => "HisCluster" );

ectool

syntax: ectool modifyCluster <projectName> <clusterName> [optionals]

Example

ectool modifyMicroservice "Default" "MyCluster" --newName "HisCluster"

Back to top

createService (deprecated)

Creates a new microservice for a project or application.

You must specify the projectName and microserviceName.

Arguments Descriptions

projectName

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

Argument Type: String

microserviceName

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

Argument Type: String

addDeployProcess

If set to true, then a service process is also created.

Argument type: Boolean

applicationName

The name of an application to scope this service to.

Argument type: String

defaultCapacity

The default service capacity.

Argument type: String

description

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

Argument Type: String

maxCapacity

The max service capacity.

Argument type: String

minCapacity

The min service capacity.

Argument type: String

volume

Volume JSON of the service.

Argument type: String

Positional arguments

projectName, microserviceName

Response

Returns a microservice element.

ec-perl

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

Example

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

ectool

syntax: ectool createService <projectName> <microserviceName> [optionals]

Example

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

Back to top

createServiceClusterMapping (deprecated)

Creates a new mapping between an application or project microservice and an environment cluster.

You must specify the projectName.

Arguments Descriptions

projectName

include::partial$name-for-the-project.adoc[

actualParameters

(Optional) Actual parameters specific to plugin procedure associated with the application service.

Argument type: Map

applicationEntityRevisionId

(Optional) Revision ID of the versioned object.

Argument type: UUID

applicationName

(Optional) The name of the application which contains the service.

Argument type: String

applicationServiceMappingName

(Optional) The name of the application service mapping.

Argument type: String

clusterName

(Optional) The name of the environment cluster.

Argument type: String

clusterProjectName

(Optional) The name of the project which contains the cluster.

Argument type: String

defaultCapacity

(Optional) The default service capacity.

Argument type: String

environmentMapName

(Optional) The name of the environment map. If not provided, will use service name and environment name to resolve environmentMap.

Argument type: String

environmentName

(Optional) The name of the environment which contains the cluster.

Argument type: String

environmentProjectName

(Optional) The name of the environment which contains the cluster.

Argument type: String

maxCapacity

(Optional) The max service capacity.

Argument type: String

minCapacity

(Optional) The min service capacity.

Argument type: String

serviceClusterMappingName

(Optional) The name of the service cluster mapping.

Argument type: String

serviceEntityRevisionId

(Optional) Revision ID of the versioned object.

Argument type: UUID

microserviceName

(Optional) The name of the independent microservice.

Argument type: String

tierMapName

(Optional) The name of the tier map. If not provided, will use application name and environment name to resolve tierMap.

Argument type: String

volume

(Optional) Volume JSON of the service.

Argument type: String

Positional arguments

projectName

Response

Returns the flowRuntimeId object.

ec-perl

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

Example

$ec->createServiceClusterMapping("service_proj1", {environmentName => "qe env name",microserviceName => "qe service 1", clusterName => "qe cluster", environmentMapName => "map", environmentProjectName => "env_proj"});

ectool

syntax: ectool createServiceClusterMapping <projectName> [optionals]

Example

ectool createServiceClusterMapping "service_proj1" --environmentName "qe env" --serviceName "qe service 1" --clusterName "qe cluster" --environmentMapName "map"  --environmentProjectName "env_proj"

Back to top

createServiceDependency (deprecated)

Adds a microservice dependency to the specified microservice.

You must specify the projectName and serviceName.

Arguments Descriptions

projectName

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

Argument Type: String

serviceName

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

Argument Type: String

dependentApplicationName

(Optional) The name of application which this application depends on.

Argument Type: String

dependentProjectName

(Optional) The name the project containing the dependent application.

Argument Type: String

dependentServiceName

(Optional) The name of service which this application depends on.

Argument Type: String

dependentSnapshotName

(Optional) The name of snapshot of the dependent application.

Argument Type: String

effectiveDate

(Optional) The date when this dependency is applicable (for example, 2006-05-15).

Argument Type: String

serviceDependencyName

(Optional) The name of the service dependency. If not specified, a system generated GUID is used.

Argument Type: String

snapshotName

(Optional) Name of the snapshot; must be unique within the application.

Argument Type: String

Positional arguments

projectName, serviceName

Response

Returns a microservice dependency for the specified microservice.

ec-perl

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

Example

$ec->createServiceDependency("service_proj1", "qe service name 1" {dependentServiceName => "qe service 3", serviceDependencyName => "dependency 1"});

ectool

syntax: ectool createServiceDependency <projectName> <serviceName> [optionals]

Example

ectool createServiceDependency "service_proj1" "qe service name 1" --dependentServiceName "qe service 3" --serviceDependencyName "dependency 1"

Back to top

deleteService (deprecated)

Deletes a microservice.

You must specify the projectName and serviceName.

Arguments Descriptions

projectName

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

Argument Type: String

serviceName

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

Argument Type: String

applicationName

Name of the application to which the application level service belongs to, null for a project-level service.

Argument Type: String

Positional arguments

projectName, serviceName

Response

None or a status OK message.

ec-perl

syntax: $<object>->deleteService (<projectName>, <serviceName>);

Example

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

ectool

syntax: ectool deleteService <projectName> <serviceName>

Example

ectool deleteService "Default" "Undeploy"

Back to top

deleteServiceClusterMapping (deprecated)

Deletes a microservice cluster mapping.

You must specify the projectName.

Arguments Descriptions

projectName

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

Argument Type: String

applicationEntityRevisionId

(Optional) Revision ID of the versioned object.

Argument Type: UUID

applicationName

(Optional) The name of the application which contains the service.

Argument Type: String

applicationServiceMappingName

(Optional) The name of the application service mapping.

Argument Type: String

clusterName

(Optional) The name of the environment cluster.

Argument Type: String

clusterProjectName

(Optional) The name of the project which contains the cluster.

Argument Type: String

environmentMapName

(Optional) The name of the environment map. If not provided, will use service name and environment name to resolve environmentMap.

Argument Type: String

environmentName

(Optional) The name of the environment which contains the cluster.

Argument Type: String

environmentProjectName

(Optional) The name of the environment which contains the cluster.

Argument Type: String

serviceClusterMappingName

(Optional) The name of the service cluster mapping.

Argument Type: String

serviceEntityRevisionId

(Optional) Revision ID of the versioned object.

Argument Type: UUID

serviceName

(Optional) The name of the independent service.

Argument Type: String

tierMapName

(Optional) The name of the tier map. If not provided, will use application name and environment name to resolve tierMap.

Argument Type: String

Positional arguments

projectName

Response

None or a status OK message.

ec-perl

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

Example

$ec->deleteServiceClusterMapping("qe proj service" {environmentName => "qe env",microserviceName => "qe service1", clusterName => "qe cluster1", environmentProjectName => "qe proj env"});

ectool

syntax: ectool deleteServiceClusterMapping <projectName> [optionals]

Example

ectool deleteServiceClusterMapping "qe proj service" --environmentName "qe env" --serviceName "qe service1" --clusterName "qe cluster1" --environmentProjectName "qe proj env"

Back to top

deleteServiceDependency (deprecated)

Deletes a microservice dependency.

You must specify the projectName and serviceName.

Arguments Descriptions

projectName

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

Argument Type: String

serviceName

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

Argument Type: String

dependentApplicationName

(Optional) The name of application which this application depends on.

Argument Type: String

dependentProjectName

(Optional) The name the project containing the dependent application.

Argument Type: String

dependentServiceName

(Optional) The name of the service which this application depends on.

Argument Type: String

dependentSnapshotName

(Optional) The name of snapshot of the dependent application.

Argument Type: String

serviceDependencyName

(Optional) The name of service dependency. If not specified, a system generated GUID is used.

Argument Type: String

snapshotName

(Optional) Name of the snapshot; must be unique within the application.

Argument Type: String

Positional arguments

projectName, serviceName

Response

None or a status OK message.

ec-perl

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

Example

$ec->deleteServiceDependency("service_proj1", "qe service name 1" {dependentServiceName => "qe service 3", serviceDependencyName => "dependency 1"});

ectool

syntax: ectool deleteServiceDependency <projectName> <serviceName> [optionals]

Example

ectool deleteServiceDependency "service_proj1" "qe service name 1" --dependentServiceName "qe service 3" --serviceDependencyName "dependency 1"

Back to top

deleteServiceMapDetail (deprecated)

Deletes a microservice detail map for the given container.

You must specify the projectName and containerName.

Arguments Descriptions

projectName

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

Argument Type: String

containerName

The name of the container.

Argument Type: String

applicationEntityRevisionId

(Optional) Revision ID of the versioned object.

Argument Type: UUID

applicationName

(Optional) The name of the application which contains the service.

Argument Type: String

applicationServiceMappingName

(Optional) The name of the application service mapping.

Argument Type: String

environmentMapName

(Optional) The name of the environment map. If not provided, will use service name and environment name to resolve environmentMap.

Argument Type: String

environmentName

(Optional) The name of the environment which contains the cluster.

Argument Type: String

environmentProjectName

(Optional) The name of the environment which contains the cluster.

Argument Type: String

serviceClusterMappingName

(Optional) The name of the application service mapping.

Argument Type: String

serviceEntityRevisionId

(Optional) Revision ID of the versioned object.

Argument Type: UUID

serviceMapDetailName

(Optional) The name of the service map detail.

Argument Type: String

serviceName

(Optional) The name of the independent service.

Argument Type: String

tierMapName

(Optional) The name of the tier map. If not provided, the application name and environment name is used to resolve tierMap.

Argument Type: String

Positional arguments

projectName, containerName

Response

None or a status OK message.

ec-perl

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

Example

$ec->deleteServiceMapDetail("service_proj1", "qe container name 1" {serviceMapDetailName => "service map detail 3"});

ectool

syntax: ectool deleteServiceMapDetail <projectName> <containerName> [optionals]

Example

ectool deleteServiceMapDetail "service_proj1" "qe container name 1" --serviceMapDetailName "service map detail 3"

Back to top

getService (deprecated)

Retrieves a microservice by name.

You must specify the projectName and serviceName.

Arguments Descriptions

projectName

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

Argument Type: String

serviceName

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

Argument Type: String

applicationEntityRevisionId

Revision ID of the versioned object.

Argument type: UUID

applicationName

The name of an application that this service is scoped to.

Argument type: String

includeDetails

True to include details (default is false ).

Argument type: Boolean

serviceEntityRevisionId

(Optional) The revision ID of the versioned object.

Argument type: UUID

Positional arguments

projectName, serviceName

Response

Retrieves the specified microservice element.

ec-perl

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

Example

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

ectool

syntax: ectool getService <projectName> <serviceName> [optionals]

Example

ectool getService "Default" "Deploy" --serviceEntityRevisionId 4fa765dd-73f1-11e3-b67e-b0a420524153

Back to top

getServices (deprecated)

Retrieves all microservices in a project or application.

You must specify the projectName.

Arguments Descriptions

projectName

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

Argument Type: String

applicationEntityRevisionId

Revision ID of the versioned object.

Argument Type: UUID

applicationName

The name of an application that this service is scoped to.

Argument Type: String

includeDetails

True to include details (default is false ).

Argument type: Boolean

includeEntityRevisions

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

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

Argument type: Boolean

Positional arguments

projectName

Response

Retrieves zero or more microservice elements.

ec-perl

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

Example

$ec->getServices("Default", {referenceProject => "Financial Summaries"});

ectool

syntax: ectool getServices <projectName> [optionals]

Example

ectool getServices "Default" --referenceProject "Financial Summaries"

Back to top

modifyService (deprecated)

Modifies an existing microservice.

You must specify the projectName and the serviceName.

Arguments Descriptions

projectName

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

Argument Type: String

serviceName

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

Argument Type: String

applicationName

The name of an application to scope this service to.

Argument type: String

defaultCapacity

The default service capacity.

Argument type: String

description

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

Argument Type: String

maxCapacity

The max service capacity.

Argument type: String

minCapacity

The min service capacity.

Argument type: String

newName

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

Argument Type: String

volume

Volume JSON of the service.

Argument type: String

Positional arguments

projectName, serviceName

Response

Returns a modified microservice element.

ec-perl

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

Example

$ec->modifyService("Default", "Deploy config", {newName=> "Deploy new service", description => "Pet store website"});

ectool

syntax: ectool modifyService <projectName> <serviceName> [optionals]

Example

ectool modifyService "Default" "Deploy config" --newName "Deploy new service" --description "Pet Store website"

Back to top

runServiceProcess (deprecated)

Runs a service process.

You must specify the projectName, serviceName, and processName.

Arguments Descriptions

projectName

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

Argument Type: String

serviceName

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

Argument Type: String

processName

The name of the application process.

Argument Type: String

actualParameters

(Optional) Parameters passed as arguments to the process.

Argument Type: Map

credentials

(Optional) Credentials to be used in the job.

Argument Type: Collection

destinationProject

(Optional) The project that will own the job.

Argument Type: String

enforceDependencies

(Optional) If application dependencies are defined for the specified application, enforce them for successful deployment.

Argument Type: Boolean

environmentMapName

(Optional) The name of the Service Environment map used to determine where to run the process.

Argument Type: String

environmentName

(Optional) Environment name to create from template.

Argument Type: String

environmentProjectName

(Optional) The name of the project to which the environment or environment template belongs to.

Argument Type: String

priority

(Optional) The priority of the job.

Argument Type: JobPriority

scheduleName

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

Argument Type: String

snapshotName

(Optional) Name for the snapshot.

Argument Type: String

validate

(Optional) Validate the process and environment.

Argument Type: Boolean

Positional arguments

projectName, serviceName, processName

Response

Returns the new job ID.

ec-perl

syntax: $<object>->runServiceProcess(<projectName>, <serviceName>, <processName>, {<optionals>});

Example

$ec->runServiceProcess("qe proj 1", "qe service", "qe proc", {environmentName => "qe env", environmentProjectName => "qe proj 2"});

ectool

syntax: ectool runServiceProcess <projectName> <serviceName> <processName> [optionals]

Example

ectool runServiceProcess "qe proj 1" "qe service" "qe proc" --environmentName "qe env" --environmentProjectName "qe proj 2"

Back to top

Job management
Object tags