Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

2.187.0

interface EcsRunTaskBaseProps

LanguageType name
.NETAmazon.CDK.AWS.Scheduler.Targets.EcsRunTaskBaseProps
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsschedulertargets#EcsRunTaskBaseProps
Javasoftware.amazon.awscdk.services.scheduler.targets.EcsRunTaskBaseProps
Pythonaws_cdk.aws_scheduler_targets.EcsRunTaskBaseProps
TypeScript (source)aws-cdk-lib » aws_scheduler_targets » EcsRunTaskBaseProps

Parameters for scheduling ECS Run Task (common to EC2 and Fargate launch types).

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as cdk from 'aws-cdk-lib';
import { aws_ec2 as ec2 } from 'aws-cdk-lib';
import { aws_ecs as ecs } from 'aws-cdk-lib';
import { aws_iam as iam } from 'aws-cdk-lib';
import { aws_scheduler as scheduler } from 'aws-cdk-lib';
import { aws_scheduler_targets as scheduler_targets } from 'aws-cdk-lib';
import { aws_sqs as sqs } from 'aws-cdk-lib';

declare const queue: sqs.Queue;
declare const role: iam.Role;
declare const scheduleTargetInput: scheduler.ScheduleTargetInput;
declare const securityGroup: ec2.SecurityGroup;
declare const subnet: ec2.Subnet;
declare const subnetFilter: ec2.SubnetFilter;
declare const taskDefinition: ecs.TaskDefinition;
const ecsRunTaskBaseProps: scheduler_targets.EcsRunTaskBaseProps = {
  taskDefinition: taskDefinition,

  // the properties below are optional
  capacityProviderStrategies: [{
    capacityProvider: 'capacityProvider',

    // the properties below are optional
    base: 123,
    weight: 123,
  }],
  deadLetterQueue: queue,
  enableEcsManagedTags: false,
  enableExecuteCommand: false,
  group: 'group',
  input: scheduleTargetInput,
  maxEventAge: cdk.Duration.minutes(30),
  propagateTags: false,
  referenceId: 'referenceId',
  retryAttempts: 123,
  role: role,
  securityGroups: [securityGroup],
  tags: [{
    key: 'key',
    value: 'value',
  }],
  taskCount: 123,
  vpcSubnets: {
    availabilityZones: ['availabilityZones'],
    onePerAz: false,
    subnetFilters: [subnetFilter],
    subnetGroupName: 'subnetGroupName',
    subnets: [subnet],
    subnetType: ec2.SubnetType.PRIVATE_ISOLATED,
  },
};

Properties

NameTypeDescription
taskDefinitionTaskDefinitionThe task definition to use for scheduled tasks.
capacityProviderStrategies?CapacityProviderStrategy[]The capacity provider strategy to use for the task.
deadLetterQueue?IQueueThe SQS queue to be used as deadLetterQueue.
enableEcsManagedTags?booleanSpecifies whether to enable Amazon ECS managed tags for the task.
enableExecuteCommand?booleanWhether to enable execute command functionality for the containers in this task.
group?stringSpecifies an ECS task group for the task.
input?ScheduleTargetInputInput passed to the target.
maxEventAge?DurationThe maximum age of a request that Scheduler sends to a target for processing.
propagateTags?booleanSpecifies whether to propagate the tags from the task definition to the task.
referenceId?stringThe reference ID to use for the task.
retryAttempts?numberThe maximum number of times to retry when the target returns an error.
role?IRoleAn execution role is an IAM role that EventBridge Scheduler assumes in order to interact with other AWS services on your behalf.
securityGroups?ISecurityGroup[]The security groups associated with the task.
tags?Tag[]The metadata that you apply to the task to help you categorize and organize them.
taskCount?numberThe number of tasks to create based on TaskDefinition.
vpcSubnets?SubnetSelectionThe subnets associated with the task.

taskDefinition

Type: TaskDefinition

The task definition to use for scheduled tasks.

Note: this must be TaskDefinition, and not ITaskDefinition, as it requires properties that are not known for imported task definitions If you want to run a RunTask with an imported task definition, consider using a Universal target.

capacityProviderStrategies?

Type: CapacityProviderStrategy[] (optional, default: No capacity provider strategy)

The capacity provider strategy to use for the task.

deadLetterQueue?

Type: IQueue (optional, default: no dead-letter queue)

The SQS queue to be used as deadLetterQueue.

The events not successfully delivered are automatically retried for a specified period of time, depending on the retry policy of the target. If an event is not delivered before all retry attempts are exhausted, it will be sent to the dead letter queue.

enableEcsManagedTags?

Type: boolean (optional, default: false)

Specifies whether to enable Amazon ECS managed tags for the task.

enableExecuteCommand?

Type: boolean (optional, default: false)

Whether to enable execute command functionality for the containers in this task.

If true, this enables execute command functionality on all containers in the task.

group?

Type: string (optional, default: No group)

Specifies an ECS task group for the task.

input?

Type: ScheduleTargetInput (optional, default: no input.)

Input passed to the target.

maxEventAge?

Type: Duration (optional, default: Duration.hours(24))

The maximum age of a request that Scheduler sends to a target for processing.

Minimum value of 60. Maximum value of 86400.

propagateTags?

Type: boolean (optional, default: No tag propagation)

Specifies whether to propagate the tags from the task definition to the task.

If no value is specified, the tags are not propagated.

referenceId?

Type: string (optional, default: No reference ID.)

The reference ID to use for the task.

retryAttempts?

Type: number (optional, default: 185)

The maximum number of times to retry when the target returns an error.

Minimum value of 0. Maximum value of 185.

role?

Type: IRole (optional, default: created by target)

An execution role is an IAM role that EventBridge Scheduler assumes in order to interact with other AWS services on your behalf.

If none provided templates target will automatically create an IAM role with all the minimum necessary permissions to interact with the templated target. If you wish you may specify your own IAM role, then the templated targets will grant minimal required permissions.

securityGroups?

Type: ISecurityGroup[] (optional, default: The security group for the VPC is used.)

The security groups associated with the task.

These security groups must all be in the same VPC. Controls inbound and outbound network access for the task.

tags?

Type: Tag[] (optional, default: No tags)

The metadata that you apply to the task to help you categorize and organize them.

Each tag consists of a key and an optional value, both of which you define.

taskCount?

Type: number (optional, default: 1)

The number of tasks to create based on TaskDefinition.

vpcSubnets?

Type: SubnetSelection (optional, default: all private subnets of the VPC are selected.)

The subnets associated with the task.

These subnets must all be in the same VPC. The task will be launched in these subnets.

← PreviousNext →