Schedule

6 minute readReference

createSchedule

Creates a new schedule.

If both startTime and stopTime are specified, intervalUnits and interval are used to specify an interval time to repeat running the procedure.

Arguments

Argument Name Type Description

projectName

String

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

scheduleName

String

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

actualParameters

Map

Parameters passed to the invoked procedure/pipeline/process/release/workflow.

applicationName

String

The name of the application that owns the process.

applicationProjectName

String

Name for the project to which the application belongs to.

beginDate

String

The date when this schedule will begin (for example, 2006-05-15).

catalogItemName

String

Name of the catalog item to invoke.

catalogName

String

Name of the catalog containing the catalog item to invoke.

credentialName

String

The name of the credential to use for impersonation.

dataRetentionPolicyName

String

The name of the data retention policy to invoke.

description

String

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

endDate

String

The date when this schedule will end (for example, 2006-05-15). The end date is not included in the range of dates.

environmentName

String

The name of the environment used to determine where to run the process.

environmentProjectName

String

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

environmentTemplateName

String

The name of the environment template used to determine the environment where to run the process.

environmentTemplateProjectName

String

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

environmentTemplateTierMapName

String

The name of the environment template tier map used to determine how to spin up the environment which will be used to run the process.

insertRollingDeployManualStep

Boolean

True to indicate a manual step needs to be injected after each phase or batch.

interval

String

If specified, the procedure/pipeline/process/release/workflow will be rescheduled over and over again at intervals of this length. Continuous means reschedule the procedure/process/workflow as soon as the previous job finishes.

intervalUnits

IntervalUnits

Units for the interval of rescheduling.

misfirePolicy

MisfirePolicy

Specifies the misfire policy for a schedule.

monthDays

String

A list of numbers from 1-31 separated by spaces, indicating zero or more days of the month.

pipelineName

String

Name of the pipeline to invoke.

pipelineParameters

Map

Pipeline parameters used by a release schedule to override the default parameters configured in the release.

pluginKey

String

Name for the project to which the schedule belongs to.

priority

JobPriority

The priority of the job.

procedureName

String

The name of the procedure to invoke.

processName

String

The name of the application process to invoke.

releaseName

String

Name of the release to invoke.

rollingDeployEnabled

Boolean

Perform rolling deployment.

rollingDeployManualStepAssignees

Collection

A list of assignees who receive the notification when rolling deploy iteration completes.

rollingDeployManualStepCondition

NotificationType

Defines run condition on manual step created during rolling deployment.

rollingDeployPhases

Collection

One or more rolling deploy phases to be used for deployment.

scheduleDisabled

Boolean

If this box is checked, the schedule will run. You can disable this schedule whenever necessary.

snapshotName

String

The name of the snapshot to be used to invoke the application process.

stagesToRun

Collection

One or more stages to run in a pipeline.

startTime

String

The time of day to begin invoking this schedule’s procedure/pipeline/process/release/workflow (24-hour clock, for example, 17:00).

startingStage

String

Name of the starting stage in pipeline.

startingStateName

String

The name of the starting state of the workflow.

stopTime

String

The time of day to stop invoking this schedule’s procedure/pipeline/process/release/workflow (don’t start a new job after this time); time values use a 24-hour clock, for example, 17:00.

subproject

String

Name for the project to which the schedule target object belongs to.

tierMapName

String

The name of the tier map used to determine where to run the process.

tierResourceCounts

Map

Resource count per resource template tier.

timeZone

String

The time zone to use when interpreting times.

weekDays

String

Days of the week: any number of names such as Monday or Tuesday, separated by spaces.

workflowName

String

The name of the workflow to invoke.

Positional arguments

projectName, scheduleName

Usage

ec-perl

$cmdr->createSchedule(<projectName>, <scheduleName>, {<optionals>});

ectool

ectool createSchedule projectName, scheduleName, [optionals]

deleteSchedule

Deletes a schedule.

Arguments

Argument Name Type Description

projectName

String

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

scheduleName

String

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

Positional arguments

projectName, scheduleName

Usage

ec-perl

$cmdr->deleteSchedule(<projectName>, <scheduleName>);

ectool

ectool deleteSchedule projectName, scheduleName

getSchedule

Retrieves a schedule by its name.

Arguments

Argument Name Type Description

projectName

String

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

scheduleName

String

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

Positional arguments

projectName, scheduleName

Usage

ec-perl

$cmdr->getSchedule(<projectName>, <scheduleName>);

ectool

ectool getSchedule projectName, scheduleName

getSchedules

Retrieves all schedules.

Arguments

Argument Name Type Description

projectName

String

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

applicationName

String

The name of the application that owns the process.

applicationProjectName

String

Name for the project to which the application belongs to.

catalogItemName

String

The name of the catalog item.

catalogName

String

The name of the catalog.

dataRetentionPolicyName

String

The name of the data retention policy.

includeWorkflows

String

To include workflow related schedules.

pipelineName

String

The name of the pipeline.

processName

String

The name of the application process.

releaseName

String

The name of the release.

tierMapName

String

The name of the tier map used to determine where to run the process.

Positional arguments

projectName

Usage

ec-perl

$cmdr->getSchedules(<projectName>, {<optionals>});

ectool

ectool getSchedules projectName, [optionals]

modifySchedule

Modifies an existing schedule.

If both startTime and stopTime are specified, intervalUnits and interval are used to specify an interval time to repeat running the procedure.

Arguments

Argument Name Type Description

projectName

String

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

scheduleName

String

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

actualParameters

Map

Parameters passed to the invoked procedure/pipeline/process/release/workflow.

applicationName

String

The name of the application that owns the process.

beginDate

String

The date when this schedule will begin (for example, 2006-05-15).

catalogItemName

String

Name of the catalog item to invoke.

catalogName

String

Name of the catalog containing the catalog item to invoke.

clearActualParameters

Boolean

Whether or not to clear actual parameters for this object.

clearPipelineParameters

Boolean

Whether or not to clear pipeline parameters for the schedule.

credentialName

String

The name of the credential to use for impersonation.

dataRetentionPolicyName

String

The name of the data retention policy to invoke.

description

String

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

endDate

String

The date when this schedule will end (for example, 2006-05-15). The end date is not included in the range of dates.

environmentName

String

The name of the environment used to determine where to run the process.

environmentProjectName

String

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

environmentTemplateName

String

The name of the environment template used to determine the environment where to run the process.

environmentTemplateProjectName

String

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

environmentTemplateTierMapName

String

The name of the environment template tier map used to determine how to spin up the environment which will be used to run the process.

insertRollingDeployManualStep

Boolean

True to indicate a manual step needs to be injected after each phase or batch.

interval

String

If specified, the procedure/pipeline/process/release/workflow will be rescheduled over and over again at intervals of this length. Continuous means reschedule the procedure/process/workflow as soon as the previous job finishes.

intervalUnits

IntervalUnits

Units for the interval of rescheduling.

misfirePolicy

MisfirePolicy

Specifies the misfire policy for a schedule.

monthDays

String

A list of numbers from 1-31 separated by spaces, indicating zero or more days of the month.

newName

String

The new name for an existing object that is being renamed.

pipelineName

String

Name of the pipeline to invoke.

pipelineParameters

Map

Pipeline parameters used by a release schedule to override the default parameters configured in the release.

pluginKey

String

Name for the project to which the schedule belongs to.

priority

JobPriority

The priority of the job.

procedureName

String

The name of the procedure to invoke.

processName

String

The name of the application process to invoke.

releaseName

String

Name of the release to invoke.

rollingDeployEnabled

Boolean

Perform rolling deployment.

rollingDeployManualStepAssignees

Collection

A list of assignees who receive the notification when rolling deploy iteration completes.

rollingDeployManualStepCondition

NotificationType

Defines run condition on manual step created during rolling deployment.

rollingDeployPhases

Collection

One or more rolling deploy phases to be used for deployment.

scheduleDisabled

Boolean

If this box is checked, the schedule will run. You can disable this schedule whenever necessary.

snapshotName

String

The name of the snapshot to be used to invoke the application process.

stagesToRun

Collection

One or more stages to run in a pipeline.

startTime

String

The time of day to begin invoking this schedule’s procedure/pipeline/process/release/workflow (24-hour clock, for example, 17:00).

startingStage

String

Name of the starting stage in pipeline.

startingStateName

String

The name of the starting state of the workflow.

stopTime

String

The time of day to stop invoking this schedule’s procedure/pipeline/process/release/workflow (don’t start a new job after this time); time values use a 24-hour clock, for example, 17:00.

subproject

String

Name for the project to which the schedule target object belongs to.

tierMapName

String

The name of the tier map used to determine where to run the process.

tierResourceCounts

Map

Resource count per resource template tier.

timeZone

String

The time zone to use when interpreting times.

weekDays

String

Days of the week: any number of names such as Monday or Tuesday, separated by spaces.

workflowName

String

The name of the workflow to invoke.

Positional arguments

projectName, scheduleName

Usage

ec-perl

$cmdr->modifySchedule(<projectName>, <scheduleName>, {<optionals>});

ectool

ectool modifySchedule projectName, scheduleName, [optionals]