createSchedule

Summary

Create 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.

projectName

Stringrequired

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

scheduleName

Stringrequired

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

actualParameters

Mapoptional

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

applicationName

Stringoptional

The name of the application that owns the process.

applicationProjectName

Stringoptional

Name for the project to which the application belongs to.

beginDate

Stringoptional

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

catalogItemName

Stringoptional

Name of the catalog item to invoke.

catalogName

Stringoptional

Name of the catalog containing the catalog item to invoke.

credentialName

Stringoptional

The name of the credential to use for impersonation.

dataRetentionPolicyName

Stringoptional

The name of the data retention policy to invoke.

description

Stringoptional

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

endDate

Stringoptional

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

environmentName

Stringoptional

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

environmentProjectName

Stringoptional

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

environmentTemplateName

Stringoptional

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

environmentTemplateProjectName

Stringoptional

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

environmentTemplateTierMapName

Stringoptional

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

Booleanoptional

True to indicate a manual step to inject after each phase or batch.

interval

Stringoptional

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

Stringoptional

Units for the interval of rescheduling.

Possible values: "continuous", "hours", "minutes", "seconds"

misfirePolicy

Stringoptional

Specifies the misfire policy for a schedule.

Possible values: "ignore", "runOnce"

monthDays

Stringoptional

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

pipelineName

Stringoptional

Name of the pipeline to invoke.

pipelineParameters

Mapoptional

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

pluginKey

Stringoptional

Name for the project to which the schedule belongs to.

priority

Stringoptional

The priority of the job.

Possible values: "low", "normal", "high", "highest"

procedureName

Stringoptional

The name of the procedure to invoke.

processName

Stringoptional

The name of the application process to invoke.

releaseName

Stringoptional

Name of the release to invoke.

rollingDeployEnabled

Booleanoptional

Perform rolling deployment.

rollingDeployManualStepAssignees

Collectionoptional

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

rollingDeployManualStepCondition

Stringoptional

Defines run condition on manual step created during rolling deployment.

Possible values: "always", "failure", "success"

rollingDeployPhases

Collectionoptional

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

scheduleDisabled

Booleanoptional

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

snapshotName

Stringoptional

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

stagesToRun

Collectionoptional

One or more stages to run in a pipeline.

startTime

Stringoptional

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

startingStage

Stringoptional

Name of the starting stage in pipeline.

startingStateName

Stringoptional

The name of the starting state of the workflow.

stopTime

Stringoptional

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

Stringoptional

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

tierMapName

Stringoptional

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

tierResourceCounts

Mapoptional

Resource count per resource template tier.

timeZone

Stringoptional

The time zone to use when interpreting times.

weekDays

Stringoptional

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

workflowName

Stringoptional

The name of the workflow to invoke.

Usage

Perl

$cmdr->createSchedule(
  "test-projectName", # projectName
  "test-scheduleName" # scheduleName
  # optionals
);▼

ectool

ectool createSchedule \
  "test-projectName" `# projectName` \
  "test-scheduleName" `# scheduleName` \
  # optionals▼

Examples

Perl

$cmdr->createSchedule('Sample Project', 'Weekend', {startTime => '00:00',
        stopTime => '23:59',
        weekDays => 'Saturday Sunday',
        interval => 1,
   intervalUnits => 'hours',
actualParameter => [{actualParameterName => 'param1', value => 'value1'}] });▼

ectool

ectool createSchedule "Sample Project" "Weekend" --startTime 00:00 --stopTime 23:59 --weekDays "Saturday Sunday" --interval 1 --intervalUnits hours▼