ectool API error messages

14 minute readReferenceTroubleshooting
Error message Context

AccessDenied

You cannot perform the specified operation on an object.

A user with Change privilege on the object can grant you the appropriate permissions.

BatchFailed

When a client uses a single transaction batch API and one operation fails, all subsequent operations in the batch API are skipped.

To resolve this error, find the failed operation in the batch API, fix it, and retry the batch API.

CantExtractPlugin

When a plugin is installed, the CloudBees CD/RO server cannot extract the plugin contents from the JAR file or has a problem storing the contents in the plugins directory.

CantSignCertificate

The server cannot sign the certificate provided by an agent.

When the server calls the eccert Perl script to sign the certificate and it fails, the server returns this error code and an eccert error message to the agent.

The details in the error message describe the appropriate corrective actions.

CantSpecifyWeekDaysAndMonthDays

A schedule can be configured to execute only on specific days of the week or on specific days of the month.

This error code appears when the one of the following scenarios occurs:

  • When you call the createSchedule or modifySchedule API command, you cannot specify both the weekDays and monthDays arguments.

  • When you modify a schedule with weekDays settings, you cannot specify the monthDays argument to change when the schedule is executed. The schedule is already configured with the weekDays settings.

  • When you modify a schedule with monthDays settings, you cannot specify the weekDays argument to change when the schedule is executed.

Corrective actions:

  • To change when a schedule is executed from weekDays to monthDays, specify the weekDays argument with an empty value in the modifySchedule command.

  • To change when a schedule is executed from monthDays to weekDays, specify the monthDays argument with an empty value in the modifySchedule command.

CircularProcedureReference

A step in a job is invoking a procedure in the call chain. This call can cause an infinite loop and is not supported.

ComponentInUse

The system attempted to delete a component, but the component is associated with one or more application tiers and cannot be deleted.

To delete the component, remove the component from the application tiers and then delete it.

CredentialAlreadyAttached

When a schedule is created or a procedure is running, the user tried to set an impersonation credential. However, the procedure already has an impersonation credential, and a new credential cannot be configured to run the procedure.

DatabaseError

The server cannot communicate with the database.

The details in the error message describe the appropriate corrective actions.

DuplicateAclEntry

When a new ACL entry is created, imported, or cloned, the system found an existing entry with the same principal (user or group).

DuplicateActualParameter

When an actual parameter is created, imported, or cloned on a schedule, subprocedure step, or subprocess step, the system found an existing parameter with the same name.

DuplicateApplicationName

When an application in a project is created, imported, or renamed, the system found an existing application with the same name.

DuplicateApplicationTierName

When an application tier in an application is created, imported, renamed, or cloned, the system found an existing application tier with the same name.

DuplicateArtifact

When an artifact is created or imported, the system found an existing artifact with the same groupId and artifactKey.

DuplicateArtifactVersionName

When an artifact version is published, imported, or renamed, the system found an existing one with the same artifactVersion.

DuplicateComponentName

When a component in an application or project is created, imported, renamed, or cloned, the system found an existing component with the same name.

DuplicateConfigName

When an email configuration is created or renamed, the system found an existing email configuration with same settings.

DuplicateCredentialName

When a credential is created, imported, or cloned, the system found an existing credential with the same name.

DuplicateDirectoryProviderName

When a directory provider is created, imported, renamed, or cloned, the system found an existing provider with the same name.

DuplicateEnvironmentInventoryItemName

When an environment inventory item is created, copied, or cloned, the system found an existing environment inventory item with the same name.

DuplicateEnvironmentName

When an environment is created, imported, rename, or cloned, the system found existing environment with the same name.

DuplicateEnvironmentTierName

When an environment tier is created, imported, or renamed, the system found existing environment tier with the same name.

DuplicateGatewayName

When a gateway is created, imported, renamed, or cloned , the system found an existing gateway with the same name.

DuplicateGraphName

When a graph is created, imported, renamed, or cloned,the system found an existing graph with the same name.

DuplicateGroupName

When a group of users in the groups list or a directory provider is created, imported, renamed, or cloned, the system found an existing group with the same name.

DuplicateJobName

When a job is run, imported, renamed, or cloned, the system found an existing job with the same name.

DuplicateLogEntryName

When a log entry is created or imported, the system found an existing log entry with the same ID.

DuplicateNotifierName

When an email notifier on a procedure, procedure step, job, state definition, or state is created, imported, renamed, or cloned, the system found an existing email notifier with the same name.

DuplicateObject

When an object is imported, the system found an existing object with the same ID.

DuplicateParameterName

When a formal parameter on a procedure or process is created, imported, or renamed, the system found an existing parameter with the same name.

DuplicatePlugin

When a plugin is created, the system found an existing plugin with the same key and version.

DuplicateProcedureName

When a procedure is created, imported, renamed, or cloned, the system found an existing procedure with the same name.

DuplicateProcessDependency

When a process dependency between two process steps is created or rewired, the system found an existing dependency between the steps.

DuplicateProcessName

When an application process is created, imported, or renamed, the system found an existing process with the same name.

DuplicateProcessStepName

When an application process step is created, imported, or renamed, the system found an existing process step with the same name.

DuplicateProjectName

This error code appears when the one of the following scenarios occurs:

  • When a project is created, imported, cloned, or renamed, the system found an existing project with the same name.

  • When you install a plugin with an existing plugin project.

To overwrite the existing project, use the force argument of the installPlugin command.

DuplicatePropertyName

When a property is created, cloned, or renamed, the system found an existing property with the same name.

DuplicateRepositoryName

When a repository is created, imported, or renamed, the system found an existing repository with the same name.

DuplicateResourceName

This error code appears when the one of the following scenarios occurs:

  • When a resource is created, imported, cloned, or renamed, the system found an existing resource with the same name.

  • When you create a resource pool that has the same name as an existing resource.

To resolve this error, delete the old resource, and then create the resource pool.

DuplicateResourcePoolName

When a resource pool is created, imported, cloned, or renamed, the system found a resource pool with the same name.

DuplicateScheduleName

When a schedule is created, imported, cloned, or renamed, the system found an existing schedule with the same name.

DuplicateStateDefinitionName

When a state in a workflow definition is created, imported, cloned, or renamed, the system found an existing one with the same name.

DuplicateStepName

The specified stepName is the same as an existing stateName.

DuplicateTierMap

When a tier map between an application and an environment is created or imported, the system found an existing tier map between the application and environment.

DuplicateTierMapName

When a tier map is created, imported, or renamed, the system found an existing tier map with the same name.

DuplicateTransitionDefinitionName

When a transition definition is created, imported, cloned, or renamed , the system found an existing one with the same name.

DuplicateTransitionName

When a transition created or imported, the system found an existing transition with the same name.

DuplicateUserName

When a user’s settings are created, imported, cloned, renamed or migrated, the system found existing settings with the same name.

DuplicateWorkflowDefinitionName

When a workflow definition is created, imported, cloned, or renamed, the system found an existing workflowDefinitionName with the same name (up to case).

DuplicateWorkflowName

When a workflow is running or imported, the system found an existing workflow with the same name.

DuplicateWorkspaceName

When a workspace is created, imported, cloned, or renamed, the system found an existing workspace with the same name.

DuplicateZoneName

When a zone is created, imported, cloned, or renamed, the system found an existing zone with the same name.

EmailNotificationFailure

When the system uses the sendEmail API command to send an email, it could not be sent due to an error. Refer to the returned error message for the appropriate course of action.

ExpiredLicense

The CloudBees CD/RO server license has expired.

ExpiredSession

When the system is performing an operation, the session expired because you do not have a logged-in session.

The session could have become invalidated due to an import operation, session timeout, or manual logout.

IncompatibleExportType

When a full import operation was attempted, a property path argument ( --path ) was specified to import data under an object. The path argument can be used only for a partial import.

To resolve this error, perform the import operation without the path argument or do a partial import.

IncompatiblePlugin

While a plugin is being installed, the server determines that the plugin is incompatible with the server version. The error message has information about the plugin version that the CloudBees CD/RO server expects.

To resolve this error, upgrade the server or install a new version of the plugin that is compatible with the server.

IncompatibleProtocolVersion

A client (most likely ectool or a Perl script using the CloudBees CD/RO Perl API) sent an API request in a protocol version that the server does not support.

To resolve this error, upgrade the component (client or server) that is older.

InternalError

An internal server error has occurred. The error message has more details about it.

To resolve the error, send the CloudBees CD/RO server log for the time period during which the error occurred to CloudBees Support.

InvalidActualParameterName

The actualParameterName parameter for the API command has an invalid value. This parameter is required and must be between 1 and 255 characters.

InvalidApplicationName

applicationName is invalid.

InvalidApplicationReleaseName

The release name of the application is invalid.

InvalidApplicationTierName

applicationTierName is invalid.

InvalidArgument

The name of the argument is invalid.

InvalidArtifactKey

artifactKey is invalid.

InvalidArtifactName

artifactName is invalid.

InvalidArtifactVersionName

artifactVersionName is invalid.

InvalidArtifactVersionState

artifactVersionState is invalid.

InvalidBeginDate

The beginDate parameter for the API command has an invalid value. It must be in the yyyy-mm-dd format.

InvalidBoolean

The system cannot evaluate the specified expression and accepts only logical expressions that are evaluated to TRUE or FALSE.

InvalidBranchConditionType

The branchConditionType parameter for the API command has an invalid value. Valid values include none, custom, and value.

InvalidBranchType

The branchType parameter for the API command has an invalid value. Valid values include always, error, and success.

InvalidComponentName

The required componentName parameter for this API command is missing or has an invalid value. Valid values are between 1 and 255 characters in length.

InvalidComponentRequest

The component parameter to this application tier API has an invalid value. The application cannot find the component name, or the component is scoped to another application.

InvalidCredentialName

The credential name is invalid or missing.

InvalidCredentials

The credentials are invalid with either an invalid user or incorrect password.

InvalidCronInterval

The cron interval is invalid. The system cannot configure the schedule.

InvalidCustomOrdering

The custom ordering is invalid. The system cannot evaluate the JavaScript block.

InvalidDatabaseType

The databaseType parameter for this API command has an invalid value. Valid values include builtin, mysql, oracle, and sqlserver.

InvalidDateRange

The date range for the beginDate and endDate parameters is invalid. beginDate is after endDate.

InvalidDestinations

The destinations parameter for this API command has an invalid value. No destination was specified, or the value is an empty string.

InvalidEmailHeader

The email header line is invalid.

InvalidEmailNotifierContainer

The emailNotifier container is invalid.

InvalidEndDate

endDate is invalid.

InvalidEnvironmentInventoryName

The name of the environment inventory is invalid.

InvalidEnvironmentName

environmentName is invalid.

InvalidEnvironmentTierName

environmentTierName is invalid.

InvalidErrorHandling

errorHandling is invalid.

InvalidEventName

The name of the event is invalid.

InvalidEventType

eventType is invalid.

InvalidExclusiveMode

exclusiveMode is invalid.

InvalidFeatureName

featureName is invalid.

InvalidFeatureType

The feature type is invalid

InvalidFileName

fileName is invalid.

InvalidFilter

The filter is invalid.

InvalidFirstResult

firstResult is invalid.

InvalidFormalParameterName

formalParameterName is invalid.

InvalidFormattingTemplate

formattingTemplate is invalid.

InvalidFullUserNameAttribute

fullUserNameAttribute is invalid.

InvalidGatewayName

gatewayName is invalid.

InvalidGraphName

The name of the graph is invalid.

InvalidGroupBase

groupName is invalid.

InvalidGroupId

groupId is invalid.

InvalidGroupMemberAttributes

groupMemberAttributes is invalid.

InvalidGroupMemberFilter

groupMemberFilter in invalid.

InvalidGroupName

groupName is invalid.

InvalidGroupNameAttribute

groupNameAttribute is invalid.

InvalidGroupSearchFilter

groupSearchFilter is invalid.

InvalidHostName

hostName is invalid.

InvalidInteger

integer is invalid.

InvalidInterval

interval is invalid.

InvalidIntervalUnits

intervalUnits is invalid.

InvalidJobId

jopbId is invalid.

InvalidJobName

jobName is invalid.

InvalidJobStatus

jobStatus is invalid.

InvalidJobStepId

jobStepId is invalid.

InvalidJobStepParent

The parent of jobStep is invalid.

InvalidLicenseData

licenseData is invalid.

InvalidLong

long is invalid.

InvalidMailFrom

mailFrom is invalid.

InvalidMailHost

mailHost is invalid.

InvalidMailPort

mailPort is invalid.

InvalidMailProtocol

mailProtcol is invalid.

InvalidMailUser

mailUser is invalid.

InvalidMailUserPassword

mailUserPassword is invalid.

InvalidManagerDn

managerDn is invalid.

InvalidManagerPassword

managerPassword is invalid.

InvalidMaxIds

maxIds is invalid.

InvalidMaximum

maximum is invalid.

InvalidMaxResults

The maxResults value should be a positive number greater than 0 and less than 10,000.

InvalidMaxRetrievers

maxRetrievers is invalid.

InvalidMessageCounter

The message counter is invalid.

InvalidMisfirePolicy

misfirePolicy is invalid.

InvalidMonthDay

monthDay is invalid.

InvalidMonthDays

monthDays is invalid.

InvalidMultipartMode

multipartMode is invalid.

InvalidName

The name of an operation or object is invalid.

InvalidNewName

newName is invalid.

InvalidNotificationFlavor

notificationFlavor is invalid.

InvalidNotifierName

notifierName is invalid.

InvalidNumObjects

numObjects is invalid.

InvalidObjectId

objectId is invalid.

InvalidOperationArguments

The arguments for the operation is invalid.

InvalidOperator

operator is invalid.

InvalidParameterCount

The parameter count is invalid.

InvalidParameterValue

The value of the parameter is invalid.

InvalidPasskey

The passkey is invalid.

InvalidPassword

password is invalid.

InvalidPingInterval

The ping interval is invalid.

InvalidPipeline

The pipeline is invalid.

InvalidPipelineStageId

The ID of the pipeline stage is invalid.

InvalidPlugin

This error code appears with the following errors:

  • Unable to reload project.xml from plugin file

  • Unable to reload plugin configuration file

  • Unable to load plugin from uploaded file in attachment '%s'

  • Unable to load plugin from local file '%s'

  • Unable to load plugin from URL '%s'

InvalidPluginKey

The system detected illegal characters in the plugin key.

InvalidPluginLabel

The plugin label is invalid.

InvalidPluginName

pluginName is invalid.

InvalidPortNumber

The port number is invalid.

InvalidPrincipalName

principalName is invalid.

InvalidPrincipalType

principalType is invalid.

InvalidPriority

priority is invalid.

InvalidPrivilege

The privilege argument is invalid.

InvalidProcedureName

procedureName is invalid.

InvalidProcessDependency

The process dependency is invalid.

InvalidProcessName

processName is invalid.

InvalidProcessStepName

processStepName is invalid.

InvalidProductName

productName is invalid.

InvalidProfile

The profile is invalid.

InvalidProjectName

projectName is invalid.

InvalidPropertyContext

The context of the property is invalid.

InvalidPropertyDescription

The property description is invalid.

InvalidPropertyName

propertyName is invalid.

InvalidPropertyPath

The property path is invalid.

InvalidPropertySheetId

propertySheetId is invalid.

InvalidPropertySheetSpecification

The specification for the property sheet is invalid.

InvalidPropertyType

propertyType is invalid.

InvalidPropertyValue

The value of the property is invalid.

InvalidProviderName

The directory providerName is invalid.

InvalidProviderType

providerType is invalid.

InvalidQuery

The query is invalid.

InvalidRepositoryName

repositoryName is invalid.

InvalidRequestName

The name of the request is invalid.

InvalidResourceId

resourceId is invalid.

InvalidResourceName

A valid resource name must have one or more characters and be from 1 to 255 characters in length.

InvalidResourcePoolName

resourcePoolName is invalid.

InvalidRetries

retries is invalid.

InvalidSafeMode

safeMode is invalid.

InvalidSchedule

schedule is invalid.

InvalidScheduleName

scheduleName is invalid.

InvalidSchema

The database schema is invalid.

InvalidScript

The script is invalid.

InvalidServer

The server is invalid.

InvalidSessionId

The session ID is invalid.

InvalidSnapshotName

The name of a snapshot is invalid.

InvalidSortKey

The sortKey argument cannot be empty and has to be an existing property name.

InvalidSortOrder

The sortOrder argument must be provided when sortKey is specified.

InvalidStartTime

startTime is invalid.

InvalidStateDefinition

stateDefinition is invalid.

InvalidStateDefinitionName

stateDefinitionName is invalid.

InvalidStateName

stateName is invalid.

InvalidStepErrorCode

stepErrorCode is invalid.

InvalidStepId

stepId is invalid.

InvalidStepLimit

stepLimit is invalid.

InvalidStepName

stepName is invalid.

InvalidStopTime

stopTime is invalid.

InvalidSubprocedure

subprocedure is invalid.

InvalidSubprocess

The subprocess is invalid.

InvalidSubproject

subproject is invalid.

InvalidSystemObject

systemObject is invalid.

InvalidTimeLimit

timeLimit is invalid.

InvalidTimeLimitUnits

timeLimitUnits is invalid.

InvalidTimestampPattern

The pattern for timestamp is invalid.

InvalidTransition

The transition from one state to another is invalid.

InvalidTransitionDefinitionName

' transitionDefinitionName ' is required and must be between 1 and 255 characters.

InvalidTransitionName

transitionName is invalid.

InvalidTransitionTrigger

The trigger for the transition is invalid.

InvalidType

The object type is invalid.

InvalidUrl

The object url is invalid.

InvalidUserName

userName is invalid.

InvalidUserSearchFilter

userSearchFilter is invalid.

InvalidVersion

version for an operation, object, plugin, or artifact is invalid.

InvalidVersionRange

versionRange is invalid.

InvalidWeekDay

The weekday argument is invalid.

InvalidWorkflowDefinitionName

workflowDefinitionName is invalid.

InvalidWorkflowId

workflowId is invalid.

InvalidWorkflowName

workflowName is invalid.

InvalidWorkingDirectory

workingDirectory is invalid.

InvalidWorkspaceName

workspaceName is invalid.

InvalidXml

The XML file, result, or stream is invalid.

InvalidZoneName

zoneName is invalid.

IOException

An IOException error has occurred.

JobNotRunning

The job is not running.

JobsStillRunning

The job is still running.

LdapAuthenticationTestFailure

The LDAP authentication test failed.

LdapFindGroupsTestFailure

The LDAP test to find groups failed.

LdapFindUserTestFailure

The LDAP test to find users failed.

LdapSetupFailure

The LDAP directory provider was not set up.

LoginDisabled

login is disabled.

MissingArgument

The argument is missing.

MissingPipelineStages

Pipeline stages are missing.

MissingSourceState

The source state is missing

MissingTargetState

The target state is missing.

MissingTiers

Tiers are missing.

MyEventExpansionError

An error occurred when the properties in MyEvent were subjected to property expansion.

NameTooLong

The name of the operation or object is too long.

NoAvailableLicenses

There are no available licenses.

NoCredentials

The operation or object has no credentials.

NoEmailHeadersSeparator

The email header has no separators.

NonStartableState

The CloudBees CD/RO server cannot start, or the system cannot start a job, workflow, or steps.

NoStateDefinitions

There are no state definitions.

NoSuchAcl

The specified ACL does not exist.

NoSuchAclEntry

The specified aclEntry does not exist.

NoSuchActualParameter

The specified actualParameter does not exist.

NoSuchAgent

The specified agent does not exist.

NoSuchApplication

The specified application does not exist.

NoSuchApplicationTier

The specified application tier does not exist.

NoSuchArtifact

The specified artifact does not exist.

NoSuchArtifactVersion

artifactVersion does not exist.

NoSuchComponent

The specified component does not exist

NoSuchConfig

The specified configName does not exist.

NoSuchConfiguration

The specified configuration for the system or machine does not exist.

NoSuchContainer

The specified emailNotifier container does not exist.

NoSuchCredential

The specified credential does not exist.

NoSuchDirectoryProvider

The specified directory provider does not exist.

NoSuchEnvironment

The specified environment does not exist.

NoSuchEnvironmentInventoryItem

The specified environmentinventoryitem does not exist.

NoSuchEnvironmentTier

The specified environmentTier does not exist.

NoSuchFormalParameter

The specified formalParameter does not exist.

NoSuchGateway

The specified gateway does not exist.

NoSuchGroup

The specified group does not exist.

NoSuchJob

The specified job does not exist.

NoSuchJobStep

The specified jobStep does not exist.

NoSuchLicense

The specified license does not exist.

NoSuchLogEntry

The specified logEntry does not exist.

NoSuchNotifier

The specified notifier does not exist.

NoSuchObject

The specified object does not exist.

NoSuchPipeline

The specified pipeline does not exist.

NoSuchPlugin

The specified plugin does not exist.

NoSuchProcedure

The specified procedure does not exist.

NoSuchProcedureStep

The specified procedureStep does not exist.

NoSuchProcess

The specified process does not exist.

NoSuchProcessDependency

The specified process dependency does not exist.

NoSuchProcessStep

The specified process step does not exist.

NoSuchProject

The specified project does not exist.

NoSuchProperty

The specified property does not exist.

NoSuchPropertySheet

The specified propertySheet does not exist.

NoSuchRelease

The specified release does not exist.

NoSuchRepository

The specified repository does not exist.

NoSuchResource

This error code appears when the one of the following scenarios occurs:

  • The step attempted to run on a resource or resource pool that has not been defined in the system.

    To resolve the error, create the resource or resource pool and rerun the step.

  • The createGateway or modifyGateway command is issued, and either of the resources being bound together do not exist.

    To resolve the error, create the missing resources, and issue the API request again.

  • The resolveFile command is issued, and the specified file was created in a local workspace on a resource that no longer exists.

    If the file still exists on the machine, create the resource, and issue the API request again.

NoSuchResourcePool

The step attempted to run on a resource pool that has not been defined in the system.

Create a resource pool with that name and rerun the step.

NoSuchSchedule

The specified schedule does not exist.

NoSuchSnapshot

The specified snapshot does not exist.

NoSuchState

The specified state does not exist.

NoSuchStateDefinition

The specified stateDefinition does not exist.

NoSuchStateMachine

The specified state machine does not exist.

NoSuchTier

The specified tier does not exist.

NoSuchTierMap

The specified tierMap does not exist.

NoSuchTierMapping

The specified tierMapping does not exist.

NoSuchTransition

The specified transition does not exist.

NoSuchTransitionDefinition

The specified transitionDefinition does not exist.

NoSuchUser

The specified user does not exist.

NoSuchWorkflow

The specified workflow does not exist.

NoSuchWorkflowAction

The specified workflow action does not exist.

NoSuchWorkflowDefinition

The specified workflowDefinition does not exist.

NoSuchWorkspace

The specified workspace does not exist.

NoSuchZone

The specified zone does not exist.

NotifierExpansionError

An error occurred when the properties in the email notifier were subjected to property expansion.

ObjectExists

The specified object exists.

OperationNotSupportedInClusteredMode

The specified operation is not supported in clustered mode.

ParameterMismatch

The value of a parameter for a specific operation or object does not match the value of the same parameter on a different operation or object.

For example, when you upgrade the database schema, the text encoding settings of the source and target databases must match exactly.

ParameterMissing

The specified parameter is missing.

ProcedureNotSchedulable

The procedure cannot be added to the schedule.

ProcessDependencyCycle

A process dependency-related cycle exists.

ProjectAlreadyInstalled

The project is already installed.

PropertyExpansionCycle

A cycle to subject the properties to property expansion is running.

PropertyNotIncrementable

The ID number of the property cannot be incremented.

PropertyNotQueryable,

The property cannot be found with a query.

PropertyNotSettable

The property cannot be configured.

PropertyReferenceError

The step attempted to use a property that does not exist.

Create a property that references a defined parameter and rerun the step.

RequestTimeout

A timeout was requested.

ResourceInUse

The specified resource is in use.

ScriptError

The script has an error.

ServerNotReady

The server is not ready.

SetupScriptError

The setup script has an error.

TransitionCycle

The transition cycle is running.

UnableToAbortJobs

The jobs cannot be aborted.

UnableToParseGraph

The graph cannot be parsed.

UnknownError

An unknown error occurred.

UnsatisfiedDependency

The process dependency was not successfully run.

UnsupportedExportVersion

The target management system uses an unsupported version.

When your database is exported to a target management system, the export may fail.

UnsupportedType

The object type is not supported.

UpgradeError

An upgrade error occurred during the CloudBees CD/RO upgrade process.

UserExists

The specified user exists.

ValidationFailed

The validation failed.

ValueTooLong

The value is too long.