ScheduledTask

• Implements: IScheduledTask

This class encapsulates and extends the ROS resource type ALIYUN::ESS::ScheduledTask, which creates a scheduled task based on specified properties.

Initializers

import com.aliyun.ros.cdk.ess.ScheduledTask;
ScheduledTask.Builder.create(Construct scope, java.lang.String id, java.lang.Boolean enableResourcePropertyConstraint)
    .launchTime(java.lang.String)
    .launchTime(IResolvable)
//  .description(java.lang.String)
//  .description(IResolvable)
//  .desiredCapacity(java.lang.Number)
//  .desiredCapacity(IResolvable)
//  .launchExpirationTime(java.lang.Number)
//  .launchExpirationTime(IResolvable)
//  .maxValue(java.lang.Number)
//  .maxValue(IResolvable)
//  .minValue(java.lang.Number)
//  .minValue(IResolvable)
//  .recurrenceEndTime(java.lang.String)
//  .recurrenceEndTime(IResolvable)
//  .recurrenceType(java.lang.String)
//  .recurrenceType(IResolvable)
//  .recurrenceValue(java.lang.String)
//  .recurrenceValue(IResolvable)
//  .scalingGroupId(java.lang.String)
//  .scalingGroupId(IResolvable)
//  .scheduledAction(java.lang.String)
//  .scheduledAction(IResolvable)
//  .scheduledTaskName(java.lang.String)
//  .scheduledTaskName(IResolvable)
//  .taskEnabled(java.lang.Boolean)
//  .taskEnabled(IResolvable)
    .build();

scope^Required

• Type: com.aliyun.ros.cdk.core.Construct

id^Required

• Type: java.lang.String

enableResourcePropertyConstraint^Optional

• Type: java.lang.Boolean

launchTime^Required

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property launchTime: Time point at which the scheduled task is triggered.

The date format follows the ISO8601 standard and uses UTC time. It is in the format of YYYY-MM-DDThh:mmZ. If RecurrenceType is specified, the time point specified by this attribute is the default time point at which the circle is executed. If RecurrenceType is not specified, the task is executed once on the designated date and time. A time point 90 days after creation or modification cannot be entered.

description^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property description: Description of the scheduled task, which is 2-200 characters (English or Chinese) long.

desiredCapacity^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property desiredCapacity: The expected number of instances in the scaling group if the scaling method of the scaling group is to specify the number of instances.

You must specify the DesiredCapacity parameter when you create a scaling group.

launchExpirationTime^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property launchExpirationTime: Time period within which the failed scheduled task is retried.

The default value is 600s. Value range: [0, 21600]

maxValue^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property maxValue: The maximum number of instances in the scaling group if the scaling method of the scaling group is to specify the number of instances.

minValue^Optional

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

Property minValue: The minimum number of instances in the scaling group if the scaling method of the scaling group is to specify the number of instances.

recurrenceEndTime^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property recurrenceEndTime: The end time of the scheduled task.

Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mmZ format. The time must be in UTC. You cannot enter a point in time that is later than 365 days from the point in time at which the scheduled task is created.

recurrenceType^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property recurrenceType: The interval at which the scheduled task is repeatedly executed.

Valid values:

• Daily: The scheduled task is executed once every specified number of days.
• Weekly: The scheduled task is executed on each specified day of a week.
• Monthly: The scheduled task is executed on each specified day of a month.
• Cron: The scheduled task is executed based on the specified cron expression. You must specify the RecurrenceType and RecurrenceValue parameters at the same time.

recurrenceValue^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property recurrenceValue: Value of the scheduled task to be repeated.

• Daily: Only one value in the range [1,31] can be filled.
• Weekly: Multiple values can be filled. The values of Sunday to Saturday are 0 to 6 in sequence. Multiple values shall be separated by a comma ",".
• Monthly: In the format of A-B. The value range of A and B is 1 to 31, and the B value must be greater than the A value.
• Cron: A cron expression is written in UTC time and consists of the following fields: minute, hour, day, month, and week. The expression can contain the letters L and W and the following wildcard characters: commas (,), question marks (?), hyphens (-), asterisks (*), number signs (#), and forward slashes (/). RecurrenceType, RecurrenceValue and RecurrenceEndTime must be specified.

scalingGroupId^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property scalingGroupId: The ID of the scaling group whose number of instances is changed when the scheduled task is triggered.

If you specify the ScalingGroupId parameter for a scheduled task, the scaling method of the scheduled task is to specify the number of instances in the scaling group. In this case, you must specify at least one of the MinValue, MaxValue, and DesiredCapacity parameters.

You cannot specify the ScheduledAction and ScalingGroupId parameters at the same time.

scheduledAction^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property scheduledAction: The scaling rule that you want to execute when the scheduled task is triggered.

Specify the unique identifier of the scaling rule. If you specify the ScheduledAction parameter, you must select an existing scaling rule for the scheduled task.

You cannot specify the ScheduledAction and ScalingGroupId parameters at the same time.

scheduledTaskName^Optional

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Property scheduledTaskName: The name of the scheduled task.

The name must be 2 to 64 characters in length and can contain letters, digits, underscores (_), hyphens (-), and periods (.). The name must start with a letter or a digit. The name of the scheduled task must be unique in the region and within the account. By default, the value of the ScheduledTaskId parameter is used.

taskEnabled^Optional

• Type: java.lang.Boolean OR com.aliyun.ros.cdk.core.IResolvable

Property taskEnabled: Whether to enable the scheduled task.

• When the parameter is set to true, the task is enabled.
• When the parameter is set to false, the task is disabled. The default value is true.

Methods

toString

public java.lang.String toString()

Returns a string representation of this construct.

synthesize

public void synthesize(ISynthesisSession session)

Allows this construct to emit artifacts into the cloud assembly during synthesis.

This method is usually implemented by framework-level constructs such as Stack and Asset as they participate in synthesizing the cloud assembly.

session^Required

• Type: com.aliyun.ros.cdk.core.ISynthesisSession

The synthesis session.

addCondition

public void addCondition(RosCondition condition)

condition^Required

• Type: com.aliyun.ros.cdk.core.RosCondition

addCount

public void addCount(java.lang.Number OR IResolvable count)

count^Required

• Type: java.lang.Number OR com.aliyun.ros.cdk.core.IResolvable

addDependency

public void addDependency(Resource resource)

resource^Required

• Type: com.aliyun.ros.cdk.core.Resource

addResourceDesc

public void addResourceDesc(java.lang.String desc)

desc^Required

• Type: java.lang.String

applyRemovalPolicy

public void applyRemovalPolicy(RemovalPolicy policy)

policy^Required

• Type: com.aliyun.ros.cdk.core.RemovalPolicy

fetchCondition

public RosCondition fetchCondition()

fetchDependency

public java.util.List<java.lang.String> fetchDependency()

fetchResourceDesc

public java.lang.String fetchResourceDesc()

getAtt

public IResolvable getAtt(java.lang.String name)

name^Required

• Type: java.lang.String

setMetadata

public void setMetadata(java.lang.String key, java.lang.Object value)

key^Required

• Type: java.lang.String

value^Required

• Type: java.lang.Object

Static Functions

isConstruct

import com.aliyun.ros.cdk.ess.ScheduledTask;
ScheduledTask.isConstruct(java.lang.Object x)

Return whether the given object is a Construct.

x^Required

• Type: java.lang.Object

Properties

node^Required

public ConstructNode getNode();

• Type: com.aliyun.ros.cdk.core.ConstructNode

The construct tree node associated with this construct.

env^Required

public IResourceEnvironment getEnv();

• Type: com.aliyun.ros.cdk.core.IResourceEnvironment

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.

ref^Required

public java.lang.String getRef();

• Type: java.lang.String

stack^Required

public Stack getStack();

• Type: com.aliyun.ros.cdk.core.Stack

The stack in which this resource is defined.

resource^Optional

public RosResource getResource();

• Type: com.aliyun.ros.cdk.core.RosResource

attrScheduledTaskId^Required

public java.lang.Object getAttrScheduledTaskId();

• Type: java.lang.String OR com.aliyun.ros.cdk.core.IResolvable

Attribute ScheduledTaskId: ID of the scheduled task, which is generated by the system and globally unique.

props^Required

public ScheduledTaskProps getProps();

• Type: ScheduledTaskProps