Cluster

createCluster

Creates a new cluster configuration object for a microservice application.

Arguments

Argument Name	Type	Description
projectName	String	The name for the project that must be unique among all projects. (Required)
clusterName	String	The name of the cluster. (Required)
definitionParameters	DefinitionParameter array	Cluster definition parameter.
description	String	Comment text describing this object that is not interpreted at all by CloudBees CD/RO.
environmentName	String	Name of the environment which owns this cluster.
pluginConfigurationName	String	Name of the plugin configuration.
pluginKey	String	Name of the plugin key.
pluginProjectName	String	Plugin project name.
providerClusterName	String	Name of the cluster on the provider platform.
providerProjectName	String	Name of the project on the provider platform.
provisionParameters	ProvisionParameter array	Provision parameter.
provisionProcedure	String	Provision procedure name.

Argument Name

Type

Description

projectName

String

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

clusterName

String

The name of the cluster. (Required)

definitionParameters

DefinitionParameter array

Cluster definition parameter.

description

String

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

environmentName

String

Name of the environment which owns this cluster.

pluginConfigurationName

String

Name of the plugin configuration.

pluginKey

String

Name of the plugin key.

pluginProjectName

String

Plugin project name.

providerClusterName

String

Name of the cluster on the provider platform.

providerProjectName

String

Name of the project on the provider platform.

provisionParameters

ProvisionParameter array

Provision parameter.

provisionProcedure

String

Provision procedure name.

Usage

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


ElectricFlow ef = new ElectricFlow()

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

deleteCluster

Deletes a cluster reference.

Arguments

Argument Name	Type	Description
projectName	String	The name for the project that must be unique among all projects. (Required)
clusterName	String	The name of the cluster. (Required)
environmentName	String	Name of the environment which owns this cluster.

Argument Name

Type

Description

projectName

String

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

clusterName

String

The name of the cluster. (Required)

environmentName

String

Name of the environment which owns this cluster.

Usage

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


ElectricFlow ef = new ElectricFlow()

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

doActionOnRealtimeCluster

Perform action on the given object in the container platform for the given CloudBees CD/RO cluster reference.

Arguments

Argument Name Type Description

Argument Name	Type	Description
projectName	String	The name for the project that must be unique among all projects. (Required)
clusterName	String	The name of the cluster. (Required)
action	String	The action to be performed on the object within the cluster. The supported values for action may vary by container platform and the type of object. Kubernetes cluster will support `viewLogs` action on `ecp-container` object type. (Required)
objectId	String	The identifier for the object within the cluster for which real-time details will be retrieved. The identifier for the object within the cluster can be obtained using `getRealtimeClusterTopology` API. (Required)
objectType	String	The type of object within the cluster for which real-time details will be retrieved. The supported values for object type may vary by container platform. Kubernetes cluster will support `ecp-namespace`, `ecp-service`, `ecp-pod`, and `ecp-container` object types. (Required)
environmentName	String	Name of the environment which owns this cluster.
actionParameters	ActionParameter array	Parameters passed as arguments for the action that should be performed on the object within the cluster.

projectName

String

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

clusterName

String

The name of the cluster. (Required)

action

String

The action to be performed on the object within the cluster. The supported values for action may vary by container platform and the type of object. Kubernetes cluster will support viewLogs action on ecp-container object type. (Required)

objectId

String

The identifier for the object within the cluster for which real-time details will be retrieved. The identifier for the object within the cluster can be obtained using getRealtimeClusterTopology API. (Required)

objectType

String

The type of object within the cluster for which real-time details will be retrieved. The supported values for object type may vary by container platform. Kubernetes cluster will support ecp-namespace, ecp-service, ecp-pod, and ecp-container object types. (Required)

environmentName

String

Name of the environment which owns this cluster.

actionParameters

ActionParameter array

Parameters passed as arguments for the action that should be performed on the object within the cluster.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.doActionOnRealtimeCluster(
                projectName: 'test-projectName',
                clusterName: 'test-clusterName',
                action: 'test-action',
                objectId: 'test-objectId',
                objectType: 'test-objectType'
                /* optional arguments */)▼

getCluster

Retrieves a cluster reference by name.

Arguments

Argument Name	Type	Description
projectName	String	The name for the project that must be unique among all projects. (Required)
clusterName	String	The name of the cluster. (Required)
environmentName	String	Name of the environment which owns this cluster.

Argument Name

Type

Description

projectName

String

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

clusterName

String

The name of the cluster. (Required)

environmentName

String

Name of the environment which owns this cluster.

Usage

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


ElectricFlow ef = new ElectricFlow()

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

getClusters

Retrieves all cluster references in a project or environment.

Arguments

Argument Name	Type	Description
projectName	String	The name for the project that must be unique among all projects. (Required)
environmentName	String	Name of the environment which owns this cluster.

Argument Name

Type

Description

projectName

String

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

environmentName

String

Name of the environment which owns this cluster.

Usage

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


ElectricFlow ef = new ElectricFlow()

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

getRealtimeClusterDetails

Retrieves details for the given object from the container platform for the given CloudBees CD/RO cluster reference.

Arguments

Argument Name Type Description

Argument Name	Type	Description
projectName	String	The name for the project that must be unique among all projects. (Required)
clusterName	String	The name of the cluster. (Required)
objectId	String	The identifier for the object within the cluster for which real-time details will be retrieved. The identifier for the object within the cluster can be obtained using `getRealtimeClusterTopology` API. (Required)
objectType	String	The type of object within the cluster for which real-time details will be retrieved. The supported values for object type may vary by container platform. Kubernetes cluster will support `ecp-namespace`, `ecp-service`, `ecp-pod`, and `ecp-container` object types. (Required)
environmentName	String	Name of the environment which owns this cluster.

projectName

String

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

clusterName

String

The name of the cluster. (Required)

objectId

String

The identifier for the object within the cluster for which real-time details will be retrieved. The identifier for the object within the cluster can be obtained using getRealtimeClusterTopology API. (Required)

objectType

String

The type of object within the cluster for which real-time details will be retrieved. The supported values for object type may vary by container platform. Kubernetes cluster will support ecp-namespace, ecp-service, ecp-pod, and ecp-container object types. (Required)

environmentName

String

Name of the environment which owns this cluster.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.getRealtimeClusterDetails(
                projectName: 'test-projectName',
                clusterName: 'test-clusterName',
                objectId: 'test-objectId',
                objectType: 'test-objectType')▼

getRealtimeClusterTopology

Retrieves cluster topology from the container platform for the given CloudBees CD/RO cluster reference.

Arguments

Argument Name	Type	Description
projectName	String	The name for the project that must be unique among all projects. (Required)
clusterName	String	The name of the cluster. (Required)
environmentName	String	Name of the environment which owns this cluster.

Argument Name

Type

Description

projectName

String

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

clusterName

String

The name of the cluster. (Required)

environmentName

String

Name of the environment which owns this cluster.

Usage

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


ElectricFlow ef = new ElectricFlow()

def result = ef.getRealtimeClusterTopology(
                projectName: 'test-projectName',
                clusterName: 'test-clusterName')▼

modifyCluster

Modifies an existing cluster configuration object for a microservice application.

Arguments

Argument Name	Type	Description
projectName	String	The name for the project that must be unique among all projects. (Required)
clusterName	String	The name of the cluster. (Required)
definitionParameters	DefinitionParameter array	Cluster definition parameter.
description	String	Comment text describing this object that is not interpreted at all by CloudBees CD/RO.
environmentName	String	Name of the environment which owns this cluster.
newName	String	New name for an existing object that is being renamed.
pluginConfigurationName	String	Name of the plugin configuration.
pluginKey	String	Name of the plugin key.
pluginProjectName	String	Plugin project name.
providerClusterName	String	Name of the cluster on the provider platform.
providerProjectName	String	Name of the project on the provider platform.
provisionParameters	ProvisionParameter array	Provision parameter.
provisionProcedure	String	Provision procedure name.

Argument Name

Type

Description

projectName

String

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

clusterName

String

The name of the cluster. (Required)

definitionParameters

DefinitionParameter array

Cluster definition parameter.

description

String

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

environmentName

String

Name of the environment which owns this cluster.

newName

String

New name for an existing object that is being renamed.

pluginConfigurationName

String

Name of the plugin configuration.

pluginKey

String

Name of the plugin key.

pluginProjectName

String

Plugin project name.

providerClusterName

String

Name of the cluster on the provider platform.

providerProjectName

String

Name of the project on the provider platform.

provisionParameters

ProvisionParameter array

Provision parameter.

provisionProcedure

String

Provision procedure name.

Usage

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


ElectricFlow ef = new ElectricFlow()

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