Skip to main content

Cluster Schedules

Specification

{
"name": String,
"description": String,
"expression": String,
"userName": String,
"clusterAction": String,
"startTime": String,
"endTime": String,
"timeZone": String
}

Structure values

Field NameTypeDescriptionRequiredDefault
nameStringSchedule name.Required
descriptionStringExpanded schedule information.OptionalNone
expressionStringCron expression used to schedule cluster actions. Uses the schedule’s time zone if specified, or defaults to the scheduler’s time zone (typically UTC). More detail on specifying schedules using cronexpressions can be found here –Cron Trigger Tutorial.Required
userNameStringThe account through which the cluster schedule action will be requested. Must have write permission on the cluster. Default user is the session user when the schedule is created.OptionalSession user
clusterActionStringThe action to execute for the cluster associated with this schedule. Supported values: Stop, Start, Restart.Required
startTimeStringSpecifies time after which the schedule will take effect. Requires ISO 8601 date-time format, YYYY-MM-DDThh:mm:ssZ.OptionalNone
endTimeStringSpecifies time after which the schedule will stop running. Requires ISO 8601 date-time format, YYYY-MM-DDThh:mm:ssZ.OptionalNone
timeZoneStringThe time zone in which the schedule will operate. Requires a valid Java time zone ID value, e.g. America/New_York for daylight-savings sensitive Eastern Time schedules. If not specified, the scheduler’s time zone (typically UTC) will be used.OptionalNone