1. Packages
  2. AWS Classic
  3. API Docs
  4. ecs
  5. TaskSet

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.32.0 published on Friday, Apr 19, 2024 by Pulumi

aws.ecs.TaskSet

Explore with Pulumi AI

aws logo

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.32.0 published on Friday, Apr 19, 2024 by Pulumi

    Provides an ECS task set - effectively a task that is expected to run until an error occurs or a user terminates it (typically a webserver or a database).

    See ECS Task Set section in AWS developer guide.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.ecs.TaskSet("example", {
        service: exampleAwsEcsService.id,
        cluster: exampleAwsEcsCluster.id,
        taskDefinition: exampleAwsEcsTaskDefinition.arn,
        loadBalancers: [{
            targetGroupArn: exampleAwsLbTargetGroup.arn,
            containerName: "mongo",
            containerPort: 8080,
        }],
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.ecs.TaskSet("example",
        service=example_aws_ecs_service["id"],
        cluster=example_aws_ecs_cluster["id"],
        task_definition=example_aws_ecs_task_definition["arn"],
        load_balancers=[aws.ecs.TaskSetLoadBalancerArgs(
            target_group_arn=example_aws_lb_target_group["arn"],
            container_name="mongo",
            container_port=8080,
        )])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ecs"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ecs.NewTaskSet(ctx, "example", &ecs.TaskSetArgs{
    			Service:        pulumi.Any(exampleAwsEcsService.Id),
    			Cluster:        pulumi.Any(exampleAwsEcsCluster.Id),
    			TaskDefinition: pulumi.Any(exampleAwsEcsTaskDefinition.Arn),
    			LoadBalancers: ecs.TaskSetLoadBalancerArray{
    				&ecs.TaskSetLoadBalancerArgs{
    					TargetGroupArn: pulumi.Any(exampleAwsLbTargetGroup.Arn),
    					ContainerName:  pulumi.String("mongo"),
    					ContainerPort:  pulumi.Int(8080),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.Ecs.TaskSet("example", new()
        {
            Service = exampleAwsEcsService.Id,
            Cluster = exampleAwsEcsCluster.Id,
            TaskDefinition = exampleAwsEcsTaskDefinition.Arn,
            LoadBalancers = new[]
            {
                new Aws.Ecs.Inputs.TaskSetLoadBalancerArgs
                {
                    TargetGroupArn = exampleAwsLbTargetGroup.Arn,
                    ContainerName = "mongo",
                    ContainerPort = 8080,
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.ecs.TaskSet;
    import com.pulumi.aws.ecs.TaskSetArgs;
    import com.pulumi.aws.ecs.inputs.TaskSetLoadBalancerArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new TaskSet("example", TaskSetArgs.builder()        
                .service(exampleAwsEcsService.id())
                .cluster(exampleAwsEcsCluster.id())
                .taskDefinition(exampleAwsEcsTaskDefinition.arn())
                .loadBalancers(TaskSetLoadBalancerArgs.builder()
                    .targetGroupArn(exampleAwsLbTargetGroup.arn())
                    .containerName("mongo")
                    .containerPort(8080)
                    .build())
                .build());
    
        }
    }
    
    resources:
      example:
        type: aws:ecs:TaskSet
        properties:
          service: ${exampleAwsEcsService.id}
          cluster: ${exampleAwsEcsCluster.id}
          taskDefinition: ${exampleAwsEcsTaskDefinition.arn}
          loadBalancers:
            - targetGroupArn: ${exampleAwsLbTargetGroup.arn}
              containerName: mongo
              containerPort: 8080
    

    Ignoring Changes to Scale

    You can utilize the generic resource lifecycle configuration block with ignore_changes to create an ECS service with an initial count of running instances, then ignore any changes to that count caused externally (e.g. Application Autoscaling).

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.ecs.TaskSet("example", {scale: {
        value: 50,
    }});
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.ecs.TaskSet("example", scale=aws.ecs.TaskSetScaleArgs(
        value=50,
    ))
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ecs"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ecs.NewTaskSet(ctx, "example", &ecs.TaskSetArgs{
    			Scale: &ecs.TaskSetScaleArgs{
    				Value: pulumi.Float64(50),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.Ecs.TaskSet("example", new()
        {
            Scale = new Aws.Ecs.Inputs.TaskSetScaleArgs
            {
                Value = 50,
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.ecs.TaskSet;
    import com.pulumi.aws.ecs.TaskSetArgs;
    import com.pulumi.aws.ecs.inputs.TaskSetScaleArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new TaskSet("example", TaskSetArgs.builder()        
                .scale(TaskSetScaleArgs.builder()
                    .value(50)
                    .build())
                .build());
    
        }
    }
    
    resources:
      example:
        type: aws:ecs:TaskSet
        properties:
          scale:
            value: 50
    

    Create TaskSet Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new TaskSet(name: string, args: TaskSetArgs, opts?: CustomResourceOptions);
    @overload
    def TaskSet(resource_name: str,
                args: TaskSetArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def TaskSet(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                service: Optional[str] = None,
                cluster: Optional[str] = None,
                task_definition: Optional[str] = None,
                force_delete: Optional[bool] = None,
                launch_type: Optional[str] = None,
                load_balancers: Optional[Sequence[TaskSetLoadBalancerArgs]] = None,
                network_configuration: Optional[TaskSetNetworkConfigurationArgs] = None,
                platform_version: Optional[str] = None,
                scale: Optional[TaskSetScaleArgs] = None,
                capacity_provider_strategies: Optional[Sequence[TaskSetCapacityProviderStrategyArgs]] = None,
                service_registries: Optional[TaskSetServiceRegistriesArgs] = None,
                tags: Optional[Mapping[str, str]] = None,
                external_id: Optional[str] = None,
                wait_until_stable: Optional[bool] = None,
                wait_until_stable_timeout: Optional[str] = None)
    func NewTaskSet(ctx *Context, name string, args TaskSetArgs, opts ...ResourceOption) (*TaskSet, error)
    public TaskSet(string name, TaskSetArgs args, CustomResourceOptions? opts = null)
    public TaskSet(String name, TaskSetArgs args)
    public TaskSet(String name, TaskSetArgs args, CustomResourceOptions options)
    
    type: aws:ecs:TaskSet
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args TaskSetArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args TaskSetArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args TaskSetArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TaskSetArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TaskSetArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

    The following reference example uses placeholder values for all input properties.

    var taskSetResource = new Aws.Ecs.TaskSet("taskSetResource", new()
    {
        Service = "string",
        Cluster = "string",
        TaskDefinition = "string",
        ForceDelete = false,
        LaunchType = "string",
        LoadBalancers = new[]
        {
            new Aws.Ecs.Inputs.TaskSetLoadBalancerArgs
            {
                ContainerName = "string",
                ContainerPort = 0,
                LoadBalancerName = "string",
                TargetGroupArn = "string",
            },
        },
        NetworkConfiguration = new Aws.Ecs.Inputs.TaskSetNetworkConfigurationArgs
        {
            Subnets = new[]
            {
                "string",
            },
            AssignPublicIp = false,
            SecurityGroups = new[]
            {
                "string",
            },
        },
        PlatformVersion = "string",
        Scale = new Aws.Ecs.Inputs.TaskSetScaleArgs
        {
            Unit = "string",
            Value = 0,
        },
        CapacityProviderStrategies = new[]
        {
            new Aws.Ecs.Inputs.TaskSetCapacityProviderStrategyArgs
            {
                CapacityProvider = "string",
                Weight = 0,
                Base = 0,
            },
        },
        ServiceRegistries = new Aws.Ecs.Inputs.TaskSetServiceRegistriesArgs
        {
            RegistryArn = "string",
            ContainerName = "string",
            ContainerPort = 0,
            Port = 0,
        },
        Tags = 
        {
            { "string", "string" },
        },
        ExternalId = "string",
        WaitUntilStable = false,
        WaitUntilStableTimeout = "string",
    });
    
    example, err := ecs.NewTaskSet(ctx, "taskSetResource", &ecs.TaskSetArgs{
    	Service:        pulumi.String("string"),
    	Cluster:        pulumi.String("string"),
    	TaskDefinition: pulumi.String("string"),
    	ForceDelete:    pulumi.Bool(false),
    	LaunchType:     pulumi.String("string"),
    	LoadBalancers: ecs.TaskSetLoadBalancerArray{
    		&ecs.TaskSetLoadBalancerArgs{
    			ContainerName:    pulumi.String("string"),
    			ContainerPort:    pulumi.Int(0),
    			LoadBalancerName: pulumi.String("string"),
    			TargetGroupArn:   pulumi.String("string"),
    		},
    	},
    	NetworkConfiguration: &ecs.TaskSetNetworkConfigurationArgs{
    		Subnets: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		AssignPublicIp: pulumi.Bool(false),
    		SecurityGroups: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    	},
    	PlatformVersion: pulumi.String("string"),
    	Scale: &ecs.TaskSetScaleArgs{
    		Unit:  pulumi.String("string"),
    		Value: pulumi.Float64(0),
    	},
    	CapacityProviderStrategies: ecs.TaskSetCapacityProviderStrategyArray{
    		&ecs.TaskSetCapacityProviderStrategyArgs{
    			CapacityProvider: pulumi.String("string"),
    			Weight:           pulumi.Int(0),
    			Base:             pulumi.Int(0),
    		},
    	},
    	ServiceRegistries: &ecs.TaskSetServiceRegistriesArgs{
    		RegistryArn:   pulumi.String("string"),
    		ContainerName: pulumi.String("string"),
    		ContainerPort: pulumi.Int(0),
    		Port:          pulumi.Int(0),
    	},
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	ExternalId:             pulumi.String("string"),
    	WaitUntilStable:        pulumi.Bool(false),
    	WaitUntilStableTimeout: pulumi.String("string"),
    })
    
    var taskSetResource = new TaskSet("taskSetResource", TaskSetArgs.builder()        
        .service("string")
        .cluster("string")
        .taskDefinition("string")
        .forceDelete(false)
        .launchType("string")
        .loadBalancers(TaskSetLoadBalancerArgs.builder()
            .containerName("string")
            .containerPort(0)
            .loadBalancerName("string")
            .targetGroupArn("string")
            .build())
        .networkConfiguration(TaskSetNetworkConfigurationArgs.builder()
            .subnets("string")
            .assignPublicIp(false)
            .securityGroups("string")
            .build())
        .platformVersion("string")
        .scale(TaskSetScaleArgs.builder()
            .unit("string")
            .value(0)
            .build())
        .capacityProviderStrategies(TaskSetCapacityProviderStrategyArgs.builder()
            .capacityProvider("string")
            .weight(0)
            .base(0)
            .build())
        .serviceRegistries(TaskSetServiceRegistriesArgs.builder()
            .registryArn("string")
            .containerName("string")
            .containerPort(0)
            .port(0)
            .build())
        .tags(Map.of("string", "string"))
        .externalId("string")
        .waitUntilStable(false)
        .waitUntilStableTimeout("string")
        .build());
    
    task_set_resource = aws.ecs.TaskSet("taskSetResource",
        service="string",
        cluster="string",
        task_definition="string",
        force_delete=False,
        launch_type="string",
        load_balancers=[aws.ecs.TaskSetLoadBalancerArgs(
            container_name="string",
            container_port=0,
            load_balancer_name="string",
            target_group_arn="string",
        )],
        network_configuration=aws.ecs.TaskSetNetworkConfigurationArgs(
            subnets=["string"],
            assign_public_ip=False,
            security_groups=["string"],
        ),
        platform_version="string",
        scale=aws.ecs.TaskSetScaleArgs(
            unit="string",
            value=0,
        ),
        capacity_provider_strategies=[aws.ecs.TaskSetCapacityProviderStrategyArgs(
            capacity_provider="string",
            weight=0,
            base=0,
        )],
        service_registries=aws.ecs.TaskSetServiceRegistriesArgs(
            registry_arn="string",
            container_name="string",
            container_port=0,
            port=0,
        ),
        tags={
            "string": "string",
        },
        external_id="string",
        wait_until_stable=False,
        wait_until_stable_timeout="string")
    
    const taskSetResource = new aws.ecs.TaskSet("taskSetResource", {
        service: "string",
        cluster: "string",
        taskDefinition: "string",
        forceDelete: false,
        launchType: "string",
        loadBalancers: [{
            containerName: "string",
            containerPort: 0,
            loadBalancerName: "string",
            targetGroupArn: "string",
        }],
        networkConfiguration: {
            subnets: ["string"],
            assignPublicIp: false,
            securityGroups: ["string"],
        },
        platformVersion: "string",
        scale: {
            unit: "string",
            value: 0,
        },
        capacityProviderStrategies: [{
            capacityProvider: "string",
            weight: 0,
            base: 0,
        }],
        serviceRegistries: {
            registryArn: "string",
            containerName: "string",
            containerPort: 0,
            port: 0,
        },
        tags: {
            string: "string",
        },
        externalId: "string",
        waitUntilStable: false,
        waitUntilStableTimeout: "string",
    });
    
    type: aws:ecs:TaskSet
    properties:
        capacityProviderStrategies:
            - base: 0
              capacityProvider: string
              weight: 0
        cluster: string
        externalId: string
        forceDelete: false
        launchType: string
        loadBalancers:
            - containerName: string
              containerPort: 0
              loadBalancerName: string
              targetGroupArn: string
        networkConfiguration:
            assignPublicIp: false
            securityGroups:
                - string
            subnets:
                - string
        platformVersion: string
        scale:
            unit: string
            value: 0
        service: string
        serviceRegistries:
            containerName: string
            containerPort: 0
            port: 0
            registryArn: string
        tags:
            string: string
        taskDefinition: string
        waitUntilStable: false
        waitUntilStableTimeout: string
    

    TaskSet Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The TaskSet resource accepts the following input properties:

    Cluster string
    The short name or ARN of the cluster that hosts the service to create the task set in.
    Service string
    The short name or ARN of the ECS service.
    TaskDefinition string

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    CapacityProviderStrategies List<TaskSetCapacityProviderStrategy>
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    ExternalId string
    The external ID associated with the task set.
    ForceDelete bool
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    LaunchType string
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    LoadBalancers List<TaskSetLoadBalancer>
    Details on load balancers that are used with a task set. Detailed below.
    NetworkConfiguration TaskSetNetworkConfiguration
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    PlatformVersion string
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    Scale TaskSetScale
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    ServiceRegistries TaskSetServiceRegistries
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    Tags Dictionary<string, string>
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    WaitUntilStable bool
    Whether the provider should wait until the task set has reached STEADY_STATE.
    WaitUntilStableTimeout string
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    Cluster string
    The short name or ARN of the cluster that hosts the service to create the task set in.
    Service string
    The short name or ARN of the ECS service.
    TaskDefinition string

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    CapacityProviderStrategies []TaskSetCapacityProviderStrategyArgs
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    ExternalId string
    The external ID associated with the task set.
    ForceDelete bool
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    LaunchType string
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    LoadBalancers []TaskSetLoadBalancerArgs
    Details on load balancers that are used with a task set. Detailed below.
    NetworkConfiguration TaskSetNetworkConfigurationArgs
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    PlatformVersion string
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    Scale TaskSetScaleArgs
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    ServiceRegistries TaskSetServiceRegistriesArgs
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    Tags map[string]string
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    WaitUntilStable bool
    Whether the provider should wait until the task set has reached STEADY_STATE.
    WaitUntilStableTimeout string
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    cluster String
    The short name or ARN of the cluster that hosts the service to create the task set in.
    service String
    The short name or ARN of the ECS service.
    taskDefinition String

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    capacityProviderStrategies List<TaskSetCapacityProviderStrategy>
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    externalId String
    The external ID associated with the task set.
    forceDelete Boolean
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    launchType String
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    loadBalancers List<TaskSetLoadBalancer>
    Details on load balancers that are used with a task set. Detailed below.
    networkConfiguration TaskSetNetworkConfiguration
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    platformVersion String
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    scale TaskSetScale
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    serviceRegistries TaskSetServiceRegistries
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    tags Map<String,String>
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    waitUntilStable Boolean
    Whether the provider should wait until the task set has reached STEADY_STATE.
    waitUntilStableTimeout String
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    cluster string
    The short name or ARN of the cluster that hosts the service to create the task set in.
    service string
    The short name or ARN of the ECS service.
    taskDefinition string

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    capacityProviderStrategies TaskSetCapacityProviderStrategy[]
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    externalId string
    The external ID associated with the task set.
    forceDelete boolean
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    launchType string
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    loadBalancers TaskSetLoadBalancer[]
    Details on load balancers that are used with a task set. Detailed below.
    networkConfiguration TaskSetNetworkConfiguration
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    platformVersion string
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    scale TaskSetScale
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    serviceRegistries TaskSetServiceRegistries
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    tags {[key: string]: string}
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    waitUntilStable boolean
    Whether the provider should wait until the task set has reached STEADY_STATE.
    waitUntilStableTimeout string
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    cluster str
    The short name or ARN of the cluster that hosts the service to create the task set in.
    service str
    The short name or ARN of the ECS service.
    task_definition str

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    capacity_provider_strategies Sequence[TaskSetCapacityProviderStrategyArgs]
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    external_id str
    The external ID associated with the task set.
    force_delete bool
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    launch_type str
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    load_balancers Sequence[TaskSetLoadBalancerArgs]
    Details on load balancers that are used with a task set. Detailed below.
    network_configuration TaskSetNetworkConfigurationArgs
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    platform_version str
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    scale TaskSetScaleArgs
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service_registries TaskSetServiceRegistriesArgs
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    tags Mapping[str, str]
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    wait_until_stable bool
    Whether the provider should wait until the task set has reached STEADY_STATE.
    wait_until_stable_timeout str
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    cluster String
    The short name or ARN of the cluster that hosts the service to create the task set in.
    service String
    The short name or ARN of the ECS service.
    taskDefinition String

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    capacityProviderStrategies List<Property Map>
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    externalId String
    The external ID associated with the task set.
    forceDelete Boolean
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    launchType String
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    loadBalancers List<Property Map>
    Details on load balancers that are used with a task set. Detailed below.
    networkConfiguration Property Map
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    platformVersion String
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    scale Property Map
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    serviceRegistries Property Map
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    tags Map<String>
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    waitUntilStable Boolean
    Whether the provider should wait until the task set has reached STEADY_STATE.
    waitUntilStableTimeout String
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the TaskSet resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) that identifies the task set.
    Id string
    The provider-assigned unique ID for this managed resource.
    StabilityStatus string
    The stability status. This indicates whether the task set has reached a steady state.
    Status string
    The status of the task set.
    TagsAll Dictionary<string, string>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    TaskSetId string
    The ID of the task set.
    Arn string
    The Amazon Resource Name (ARN) that identifies the task set.
    Id string
    The provider-assigned unique ID for this managed resource.
    StabilityStatus string
    The stability status. This indicates whether the task set has reached a steady state.
    Status string
    The status of the task set.
    TagsAll map[string]string
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    TaskSetId string
    The ID of the task set.
    arn String
    The Amazon Resource Name (ARN) that identifies the task set.
    id String
    The provider-assigned unique ID for this managed resource.
    stabilityStatus String
    The stability status. This indicates whether the task set has reached a steady state.
    status String
    The status of the task set.
    tagsAll Map<String,String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    taskSetId String
    The ID of the task set.
    arn string
    The Amazon Resource Name (ARN) that identifies the task set.
    id string
    The provider-assigned unique ID for this managed resource.
    stabilityStatus string
    The stability status. This indicates whether the task set has reached a steady state.
    status string
    The status of the task set.
    tagsAll {[key: string]: string}
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    taskSetId string
    The ID of the task set.
    arn str
    The Amazon Resource Name (ARN) that identifies the task set.
    id str
    The provider-assigned unique ID for this managed resource.
    stability_status str
    The stability status. This indicates whether the task set has reached a steady state.
    status str
    The status of the task set.
    tags_all Mapping[str, str]
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    task_set_id str
    The ID of the task set.
    arn String
    The Amazon Resource Name (ARN) that identifies the task set.
    id String
    The provider-assigned unique ID for this managed resource.
    stabilityStatus String
    The stability status. This indicates whether the task set has reached a steady state.
    status String
    The status of the task set.
    tagsAll Map<String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    taskSetId String
    The ID of the task set.

    Look up Existing TaskSet Resource

    Get an existing TaskSet resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: TaskSetState, opts?: CustomResourceOptions): TaskSet
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            arn: Optional[str] = None,
            capacity_provider_strategies: Optional[Sequence[TaskSetCapacityProviderStrategyArgs]] = None,
            cluster: Optional[str] = None,
            external_id: Optional[str] = None,
            force_delete: Optional[bool] = None,
            launch_type: Optional[str] = None,
            load_balancers: Optional[Sequence[TaskSetLoadBalancerArgs]] = None,
            network_configuration: Optional[TaskSetNetworkConfigurationArgs] = None,
            platform_version: Optional[str] = None,
            scale: Optional[TaskSetScaleArgs] = None,
            service: Optional[str] = None,
            service_registries: Optional[TaskSetServiceRegistriesArgs] = None,
            stability_status: Optional[str] = None,
            status: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None,
            task_definition: Optional[str] = None,
            task_set_id: Optional[str] = None,
            wait_until_stable: Optional[bool] = None,
            wait_until_stable_timeout: Optional[str] = None) -> TaskSet
    func GetTaskSet(ctx *Context, name string, id IDInput, state *TaskSetState, opts ...ResourceOption) (*TaskSet, error)
    public static TaskSet Get(string name, Input<string> id, TaskSetState? state, CustomResourceOptions? opts = null)
    public static TaskSet get(String name, Output<String> id, TaskSetState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Arn string
    The Amazon Resource Name (ARN) that identifies the task set.
    CapacityProviderStrategies List<TaskSetCapacityProviderStrategy>
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    Cluster string
    The short name or ARN of the cluster that hosts the service to create the task set in.
    ExternalId string
    The external ID associated with the task set.
    ForceDelete bool
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    LaunchType string
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    LoadBalancers List<TaskSetLoadBalancer>
    Details on load balancers that are used with a task set. Detailed below.
    NetworkConfiguration TaskSetNetworkConfiguration
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    PlatformVersion string
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    Scale TaskSetScale
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    Service string
    The short name or ARN of the ECS service.
    ServiceRegistries TaskSetServiceRegistries
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    StabilityStatus string
    The stability status. This indicates whether the task set has reached a steady state.
    Status string
    The status of the task set.
    Tags Dictionary<string, string>
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    TagsAll Dictionary<string, string>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    TaskDefinition string

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    TaskSetId string
    The ID of the task set.
    WaitUntilStable bool
    Whether the provider should wait until the task set has reached STEADY_STATE.
    WaitUntilStableTimeout string
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    Arn string
    The Amazon Resource Name (ARN) that identifies the task set.
    CapacityProviderStrategies []TaskSetCapacityProviderStrategyArgs
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    Cluster string
    The short name or ARN of the cluster that hosts the service to create the task set in.
    ExternalId string
    The external ID associated with the task set.
    ForceDelete bool
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    LaunchType string
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    LoadBalancers []TaskSetLoadBalancerArgs
    Details on load balancers that are used with a task set. Detailed below.
    NetworkConfiguration TaskSetNetworkConfigurationArgs
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    PlatformVersion string
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    Scale TaskSetScaleArgs
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    Service string
    The short name or ARN of the ECS service.
    ServiceRegistries TaskSetServiceRegistriesArgs
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    StabilityStatus string
    The stability status. This indicates whether the task set has reached a steady state.
    Status string
    The status of the task set.
    Tags map[string]string
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    TagsAll map[string]string
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    TaskDefinition string

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    TaskSetId string
    The ID of the task set.
    WaitUntilStable bool
    Whether the provider should wait until the task set has reached STEADY_STATE.
    WaitUntilStableTimeout string
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    arn String
    The Amazon Resource Name (ARN) that identifies the task set.
    capacityProviderStrategies List<TaskSetCapacityProviderStrategy>
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster String
    The short name or ARN of the cluster that hosts the service to create the task set in.
    externalId String
    The external ID associated with the task set.
    forceDelete Boolean
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    launchType String
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    loadBalancers List<TaskSetLoadBalancer>
    Details on load balancers that are used with a task set. Detailed below.
    networkConfiguration TaskSetNetworkConfiguration
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    platformVersion String
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    scale TaskSetScale
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service String
    The short name or ARN of the ECS service.
    serviceRegistries TaskSetServiceRegistries
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    stabilityStatus String
    The stability status. This indicates whether the task set has reached a steady state.
    status String
    The status of the task set.
    tags Map<String,String>
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    tagsAll Map<String,String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    taskDefinition String

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    taskSetId String
    The ID of the task set.
    waitUntilStable Boolean
    Whether the provider should wait until the task set has reached STEADY_STATE.
    waitUntilStableTimeout String
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    arn string
    The Amazon Resource Name (ARN) that identifies the task set.
    capacityProviderStrategies TaskSetCapacityProviderStrategy[]
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster string
    The short name or ARN of the cluster that hosts the service to create the task set in.
    externalId string
    The external ID associated with the task set.
    forceDelete boolean
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    launchType string
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    loadBalancers TaskSetLoadBalancer[]
    Details on load balancers that are used with a task set. Detailed below.
    networkConfiguration TaskSetNetworkConfiguration
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    platformVersion string
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    scale TaskSetScale
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service string
    The short name or ARN of the ECS service.
    serviceRegistries TaskSetServiceRegistries
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    stabilityStatus string
    The stability status. This indicates whether the task set has reached a steady state.
    status string
    The status of the task set.
    tags {[key: string]: string}
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    tagsAll {[key: string]: string}
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    taskDefinition string

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    taskSetId string
    The ID of the task set.
    waitUntilStable boolean
    Whether the provider should wait until the task set has reached STEADY_STATE.
    waitUntilStableTimeout string
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    arn str
    The Amazon Resource Name (ARN) that identifies the task set.
    capacity_provider_strategies Sequence[TaskSetCapacityProviderStrategyArgs]
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster str
    The short name or ARN of the cluster that hosts the service to create the task set in.
    external_id str
    The external ID associated with the task set.
    force_delete bool
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    launch_type str
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    load_balancers Sequence[TaskSetLoadBalancerArgs]
    Details on load balancers that are used with a task set. Detailed below.
    network_configuration TaskSetNetworkConfigurationArgs
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    platform_version str
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    scale TaskSetScaleArgs
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service str
    The short name or ARN of the ECS service.
    service_registries TaskSetServiceRegistriesArgs
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    stability_status str
    The stability status. This indicates whether the task set has reached a steady state.
    status str
    The status of the task set.
    tags Mapping[str, str]
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    tags_all Mapping[str, str]
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    task_definition str

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    task_set_id str
    The ID of the task set.
    wait_until_stable bool
    Whether the provider should wait until the task set has reached STEADY_STATE.
    wait_until_stable_timeout str
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.
    arn String
    The Amazon Resource Name (ARN) that identifies the task set.
    capacityProviderStrategies List<Property Map>
    The capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster String
    The short name or ARN of the cluster that hosts the service to create the task set in.
    externalId String
    The external ID associated with the task set.
    forceDelete Boolean
    Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.
    launchType String
    The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    loadBalancers List<Property Map>
    Details on load balancers that are used with a task set. Detailed below.
    networkConfiguration Property Map
    The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.
    platformVersion String
    The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    scale Property Map
    A floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service String
    The short name or ARN of the ECS service.
    serviceRegistries Property Map
    The service discovery registries for the service. The maximum number of service_registries blocks is 1. Detailed below.
    stabilityStatus String
    The stability status. This indicates whether the task set has reached a steady state.
    status String
    The status of the task set.
    tags Map<String>
    A map of tags to assign to the file system. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copy_tags_to_backups to true, and you specify one or more tags, no existing file system tags are copied from the file system to the backup.
    tagsAll Map<String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    taskDefinition String

    The family and revision (family:revision) or full ARN of the task definition that you want to run in your service.

    The following arguments are optional:

    taskSetId String
    The ID of the task set.
    waitUntilStable Boolean
    Whether the provider should wait until the task set has reached STEADY_STATE.
    waitUntilStableTimeout String
    Wait timeout for task set to reach STEADY_STATE. Valid time units include ns, us (or µs), ms, s, m, and h. Default 10m.

    Supporting Types

    TaskSetCapacityProviderStrategy, TaskSetCapacityProviderStrategyArgs

    CapacityProvider string
    The short name or full Amazon Resource Name (ARN) of the capacity provider.
    Weight int
    The relative percentage of the total number of launched tasks that should use the specified capacity provider.
    Base int
    The number of tasks, at a minimum, to run on the specified capacity provider. Only one capacity provider in a capacity provider strategy can have a base defined.
    CapacityProvider string
    The short name or full Amazon Resource Name (ARN) of the capacity provider.
    Weight int
    The relative percentage of the total number of launched tasks that should use the specified capacity provider.
    Base int
    The number of tasks, at a minimum, to run on the specified capacity provider. Only one capacity provider in a capacity provider strategy can have a base defined.
    capacityProvider String
    The short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight Integer
    The relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base Integer
    The number of tasks, at a minimum, to run on the specified capacity provider. Only one capacity provider in a capacity provider strategy can have a base defined.
    capacityProvider string
    The short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight number
    The relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base number
    The number of tasks, at a minimum, to run on the specified capacity provider. Only one capacity provider in a capacity provider strategy can have a base defined.
    capacity_provider str
    The short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight int
    The relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base int
    The number of tasks, at a minimum, to run on the specified capacity provider. Only one capacity provider in a capacity provider strategy can have a base defined.
    capacityProvider String
    The short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight Number
    The relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base Number
    The number of tasks, at a minimum, to run on the specified capacity provider. Only one capacity provider in a capacity provider strategy can have a base defined.

    TaskSetLoadBalancer, TaskSetLoadBalancerArgs

    ContainerName string
    The name of the container to associate with the load balancer (as it appears in a container definition).
    ContainerPort int

    The port on the container to associate with the load balancer. Defaults to 0 if not specified.

    Note: Specifying multiple load_balancer configurations is still not supported by AWS for ECS task set.

    LoadBalancerName string
    The name of the ELB (Classic) to associate with the service.
    TargetGroupArn string
    The ARN of the Load Balancer target group to associate with the service.
    ContainerName string
    The name of the container to associate with the load balancer (as it appears in a container definition).
    ContainerPort int

    The port on the container to associate with the load balancer. Defaults to 0 if not specified.

    Note: Specifying multiple load_balancer configurations is still not supported by AWS for ECS task set.

    LoadBalancerName string
    The name of the ELB (Classic) to associate with the service.
    TargetGroupArn string
    The ARN of the Load Balancer target group to associate with the service.
    containerName String
    The name of the container to associate with the load balancer (as it appears in a container definition).
    containerPort Integer

    The port on the container to associate with the load balancer. Defaults to 0 if not specified.

    Note: Specifying multiple load_balancer configurations is still not supported by AWS for ECS task set.

    loadBalancerName String
    The name of the ELB (Classic) to associate with the service.
    targetGroupArn String
    The ARN of the Load Balancer target group to associate with the service.
    containerName string
    The name of the container to associate with the load balancer (as it appears in a container definition).
    containerPort number

    The port on the container to associate with the load balancer. Defaults to 0 if not specified.

    Note: Specifying multiple load_balancer configurations is still not supported by AWS for ECS task set.

    loadBalancerName string
    The name of the ELB (Classic) to associate with the service.
    targetGroupArn string
    The ARN of the Load Balancer target group to associate with the service.
    container_name str
    The name of the container to associate with the load balancer (as it appears in a container definition).
    container_port int

    The port on the container to associate with the load balancer. Defaults to 0 if not specified.

    Note: Specifying multiple load_balancer configurations is still not supported by AWS for ECS task set.

    load_balancer_name str
    The name of the ELB (Classic) to associate with the service.
    target_group_arn str
    The ARN of the Load Balancer target group to associate with the service.
    containerName String
    The name of the container to associate with the load balancer (as it appears in a container definition).
    containerPort Number

    The port on the container to associate with the load balancer. Defaults to 0 if not specified.

    Note: Specifying multiple load_balancer configurations is still not supported by AWS for ECS task set.

    loadBalancerName String
    The name of the ELB (Classic) to associate with the service.
    targetGroupArn String
    The ARN of the Load Balancer target group to associate with the service.

    TaskSetNetworkConfiguration, TaskSetNetworkConfigurationArgs

    Subnets List<string>
    The subnets associated with the task or service. Maximum of 16.
    AssignPublicIp bool

    Whether to assign a public IP address to the ENI (FARGATE launch type only). Valid values are true or false. Default false.

    For more information, see Task Networking.

    SecurityGroups List<string>
    The security groups associated with the task or service. If you do not specify a security group, the default security group for the VPC is used. Maximum of 5.
    Subnets []string
    The subnets associated with the task or service. Maximum of 16.
    AssignPublicIp bool

    Whether to assign a public IP address to the ENI (FARGATE launch type only). Valid values are true or false. Default false.

    For more information, see Task Networking.

    SecurityGroups []string
    The security groups associated with the task or service. If you do not specify a security group, the default security group for the VPC is used. Maximum of 5.
    subnets List<String>
    The subnets associated with the task or service. Maximum of 16.
    assignPublicIp Boolean

    Whether to assign a public IP address to the ENI (FARGATE launch type only). Valid values are true or false. Default false.

    For more information, see Task Networking.

    securityGroups List<String>
    The security groups associated with the task or service. If you do not specify a security group, the default security group for the VPC is used. Maximum of 5.
    subnets string[]
    The subnets associated with the task or service. Maximum of 16.
    assignPublicIp boolean

    Whether to assign a public IP address to the ENI (FARGATE launch type only). Valid values are true or false. Default false.

    For more information, see Task Networking.

    securityGroups string[]
    The security groups associated with the task or service. If you do not specify a security group, the default security group for the VPC is used. Maximum of 5.
    subnets Sequence[str]
    The subnets associated with the task or service. Maximum of 16.
    assign_public_ip bool

    Whether to assign a public IP address to the ENI (FARGATE launch type only). Valid values are true or false. Default false.

    For more information, see Task Networking.

    security_groups Sequence[str]
    The security groups associated with the task or service. If you do not specify a security group, the default security group for the VPC is used. Maximum of 5.
    subnets List<String>
    The subnets associated with the task or service. Maximum of 16.
    assignPublicIp Boolean

    Whether to assign a public IP address to the ENI (FARGATE launch type only). Valid values are true or false. Default false.

    For more information, see Task Networking.

    securityGroups List<String>
    The security groups associated with the task or service. If you do not specify a security group, the default security group for the VPC is used. Maximum of 5.

    TaskSetScale, TaskSetScaleArgs

    Unit string
    The unit of measure for the scale value. Default: PERCENT.
    Value double
    The value, specified as a percent total of a service's desiredCount, to scale the task set. Defaults to 0 if not specified. Accepted values are numbers between 0.0 and 100.0.
    Unit string
    The unit of measure for the scale value. Default: PERCENT.
    Value float64
    The value, specified as a percent total of a service's desiredCount, to scale the task set. Defaults to 0 if not specified. Accepted values are numbers between 0.0 and 100.0.
    unit String
    The unit of measure for the scale value. Default: PERCENT.
    value Double
    The value, specified as a percent total of a service's desiredCount, to scale the task set. Defaults to 0 if not specified. Accepted values are numbers between 0.0 and 100.0.
    unit string
    The unit of measure for the scale value. Default: PERCENT.
    value number
    The value, specified as a percent total of a service's desiredCount, to scale the task set. Defaults to 0 if not specified. Accepted values are numbers between 0.0 and 100.0.
    unit str
    The unit of measure for the scale value. Default: PERCENT.
    value float
    The value, specified as a percent total of a service's desiredCount, to scale the task set. Defaults to 0 if not specified. Accepted values are numbers between 0.0 and 100.0.
    unit String
    The unit of measure for the scale value. Default: PERCENT.
    value Number
    The value, specified as a percent total of a service's desiredCount, to scale the task set. Defaults to 0 if not specified. Accepted values are numbers between 0.0 and 100.0.

    TaskSetServiceRegistries, TaskSetServiceRegistriesArgs

    RegistryArn string
    The ARN of the Service Registry. The currently supported service registry is Amazon Route 53 Auto Naming Service(aws.servicediscovery.Service resource). For more information, see Service.
    ContainerName string
    The container name value, already specified in the task definition, to be used for your service discovery service.
    ContainerPort int
    The port value, already specified in the task definition, to be used for your service discovery service.
    Port int
    The port value used if your Service Discovery service specified an SRV record.
    RegistryArn string
    The ARN of the Service Registry. The currently supported service registry is Amazon Route 53 Auto Naming Service(aws.servicediscovery.Service resource). For more information, see Service.
    ContainerName string
    The container name value, already specified in the task definition, to be used for your service discovery service.
    ContainerPort int
    The port value, already specified in the task definition, to be used for your service discovery service.
    Port int
    The port value used if your Service Discovery service specified an SRV record.
    registryArn String
    The ARN of the Service Registry. The currently supported service registry is Amazon Route 53 Auto Naming Service(aws.servicediscovery.Service resource). For more information, see Service.
    containerName String
    The container name value, already specified in the task definition, to be used for your service discovery service.
    containerPort Integer
    The port value, already specified in the task definition, to be used for your service discovery service.
    port Integer
    The port value used if your Service Discovery service specified an SRV record.
    registryArn string
    The ARN of the Service Registry. The currently supported service registry is Amazon Route 53 Auto Naming Service(aws.servicediscovery.Service resource). For more information, see Service.
    containerName string
    The container name value, already specified in the task definition, to be used for your service discovery service.
    containerPort number
    The port value, already specified in the task definition, to be used for your service discovery service.
    port number
    The port value used if your Service Discovery service specified an SRV record.
    registry_arn str
    The ARN of the Service Registry. The currently supported service registry is Amazon Route 53 Auto Naming Service(aws.servicediscovery.Service resource). For more information, see Service.
    container_name str
    The container name value, already specified in the task definition, to be used for your service discovery service.
    container_port int
    The port value, already specified in the task definition, to be used for your service discovery service.
    port int
    The port value used if your Service Discovery service specified an SRV record.
    registryArn String
    The ARN of the Service Registry. The currently supported service registry is Amazon Route 53 Auto Naming Service(aws.servicediscovery.Service resource). For more information, see Service.
    containerName String
    The container name value, already specified in the task definition, to be used for your service discovery service.
    containerPort Number
    The port value, already specified in the task definition, to be used for your service discovery service.
    port Number
    The port value used if your Service Discovery service specified an SRV record.

    Import

    Using pulumi import, import ECS Task Sets using the task_set_id, service, and cluster separated by commas (,). For example:

    $ pulumi import aws:ecs/taskSet:TaskSet example ecs-svc/7177320696926227436,arn:aws:ecs:us-west-2:123456789101:service/example/example-1234567890,arn:aws:ecs:us-west-2:123456789101:cluster/example
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo

    Try AWS Native preview for resources not in the classic version.

    AWS Classic v6.32.0 published on Friday, Apr 19, 2024 by Pulumi