public static final class CfnCanary.ScheduleProperty.Builder
extends java.lang.Object
CfnCanary.ScheduleProperty
Constructor and Description |
---|
Builder() |
Modifier and Type | Method and Description |
---|---|
CfnCanary.ScheduleProperty |
build()
Builds the configured instance.
|
CfnCanary.ScheduleProperty.Builder |
durationInSeconds(java.lang.String durationInSeconds)
Sets the value of
CfnCanary.ScheduleProperty.getDurationInSeconds() |
CfnCanary.ScheduleProperty.Builder |
expression(java.lang.String expression)
Sets the value of
CfnCanary.ScheduleProperty.getExpression() |
public CfnCanary.ScheduleProperty.Builder expression(java.lang.String expression)
CfnCanary.ScheduleProperty.getExpression()
expression
- A `rate` expression or a `cron` expression that defines how often the canary is to run. This parameter is required.
For a rate expression, The syntax is rate( *number unit* )
. unit can be minute
, minutes
, or hour
.
For example, rate(1 minute)
runs the canary once a minute, rate(10 minutes)
runs it once every 10 minutes, and rate(1 hour)
runs it once every hour. You can specify a frequency between rate(1 minute)
and rate(1 hour)
.
Specifying rate(0 minute)
or rate(0 hour)
is a special value that causes the canary to run only once when it is started.
Use cron( *expression* )
to specify a cron expression. You can't schedule a canary to wait for more than a year before running. For information about the syntax for cron expressions, see Scheduling canary runs using cron .
this
public CfnCanary.ScheduleProperty.Builder durationInSeconds(java.lang.String durationInSeconds)
CfnCanary.ScheduleProperty.getDurationInSeconds()
durationInSeconds
- How long, in seconds, for the canary to continue making regular runs according to the schedule in the `Expression` value.
If you specify 0, the canary continues making runs until you stop it. If you omit this field, the default of 0 is used.this
public CfnCanary.ScheduleProperty build()
CfnCanary.ScheduleProperty
java.lang.NullPointerException
- if any required attribute was not provided