Microservices

createMicroservice

Creates a new microservice for a project or application.

You must specify the projectName and microserviceName.

Arguments Descriptions

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

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"

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

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"

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

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"

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

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"

modifyMicroservice

Modifies an existing microservice.

You must specify the projectName and the microserviceName.

Arguments Descriptions

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

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"

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

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"

deleteMicroserviceMapping

Deletes a microservice cluster mapping.

You must specify the projectName and applicationName.

Arguments Descriptions

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

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"

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

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"

createCluster

Creates a new cluster configuration object for a microservice application.

You must specify the projectName and clusterName.

Arguments Descriptions

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`

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"

modifyCluster

Modify an existing cluster configuration object for a microservice application.

You must specify the projectName and clusterName.

Arguments Descriptions

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

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"

createService (deprecated)

Creates a new microservice for a project or application.

You must specify the projectName and microserviceName.

Arguments Descriptions

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

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"

createServiceClusterMapping (deprecated)

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

You must specify the projectName.

Arguments Descriptions

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

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"

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

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"

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

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"

deleteServiceClusterMapping (deprecated)

Deletes a microservice cluster mapping.

You must specify the projectName.

Arguments Descriptions

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

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"

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

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"

deleteServiceMapDetail (deprecated)

Deletes a microservice detail map for the given container.

You must specify the projectName and containerName.

Arguments Descriptions

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

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"

getService (deprecated)

Retrieves a microservice by name.

You must specify the projectName and serviceName.

Arguments Descriptions

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

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

getServices (deprecated)

Retrieves all microservices in a project or application.

You must specify the projectName.

Arguments Descriptions

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

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"

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

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"

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

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"