interface CfnTaskSetProps
Language | Type name |
---|---|
![]() | Amazon.CDK.AWS.ECS.CfnTaskSetProps |
![]() | software.amazon.awscdk.services.ecs.CfnTaskSetProps |
![]() | aws_cdk.aws_ecs.CfnTaskSetProps |
![]() | @aws-cdk/aws-ecs » CfnTaskSetProps |
Properties for defining a CfnTaskSet
.
Example
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as ecs from '@aws-cdk/aws-ecs';
const cfnTaskSetProps: ecs.CfnTaskSetProps = {
cluster: 'cluster',
service: 'service',
taskDefinition: 'taskDefinition',
// the properties below are optional
externalId: 'externalId',
launchType: 'launchType',
loadBalancers: [{
containerName: 'containerName',
containerPort: 123,
loadBalancerName: 'loadBalancerName',
targetGroupArn: 'targetGroupArn',
}],
networkConfiguration: {
awsVpcConfiguration: {
subnets: ['subnets'],
// the properties below are optional
assignPublicIp: 'assignPublicIp',
securityGroups: ['securityGroups'],
},
},
platformVersion: 'platformVersion',
scale: {
unit: 'unit',
value: 123,
},
serviceRegistries: [{
containerName: 'containerName',
containerPort: 123,
port: 123,
registryArn: 'registryArn',
}],
};
Properties
Name | Type | Description |
---|---|---|
cluster | string | The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service to create the task set in. |
service | string | The short name or full Amazon Resource Name (ARN) of the service to create the task set in. |
task | string | The task definition for the tasks in the task set to use. |
external | string | An optional non-unique tag that identifies this task set in external systems. |
launch | string | The launch type that new tasks in the task set uses. |
load | IResolvable | IResolvable | Load [] | A load balancer object representing the load balancer to use with the task set. |
network | IResolvable | Network | The network configuration for the task set. |
platform | string | The platform version that the tasks in the task set uses. |
scale? | IResolvable | Scale | A floating-point percentage of your desired number of tasks to place and keep running in the task set. |
service | IResolvable | IResolvable | Service [] | The details of the service discovery registries to assign to this task set. |
cluster
Type:
string
The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service to create the task set in.
service
Type:
string
The short name or full Amazon Resource Name (ARN) of the service to create the task set in.
taskDefinition
Type:
string
The task definition for the tasks in the task set to use.
externalId?
Type:
string
(optional)
An optional non-unique tag that identifies this task set in external systems.
If the task set is associated with a service discovery registry, the tasks in this task set will have the ECS_TASK_SET_EXTERNAL_ID
AWS Cloud Map attribute set to the provided value.
launchType?
Type:
string
(optional)
The launch type that new tasks in the task set uses.
For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide .
If a launchType
is specified, the capacityProviderStrategy
parameter must be omitted.
loadBalancers?
Type:
IResolvable
|
IResolvable
|
Load
[]
(optional)
A load balancer object representing the load balancer to use with the task set.
The supported load balancer types are either an Application Load Balancer or a Network Load Balancer.
networkConfiguration?
Type:
IResolvable
|
Network
(optional)
The network configuration for the task set.
platformVersion?
Type:
string
(optional)
The platform version that the tasks in the task set uses.
A platform version is specified only for tasks using the Fargate launch type. If one isn't specified, the LATEST
platform version is used.
scale?
Type:
IResolvable
|
Scale
(optional)
A floating-point percentage of your desired number of tasks to place and keep running in the task set.
serviceRegistries?
Type:
IResolvable
|
IResolvable
|
Service
[]
(optional)
The details of the service discovery registries to assign to this task set.
For more information, see Service discovery .