Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. AWS
  4. API Docs
  5. ecs
  6. TaskSet
Viewing docs for AWS v7.43.0
published on Thursday, Aug 20, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

aws.ecs.TaskSet

aws logo aws logo
Viewing docs for AWS v7.43.0
published on Thursday, Aug 20, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

    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=[{
        "target_group_arn": example_aws_lb_target_group["arn"],
        "container_name": "mongo",
        "container_port": 8080,
    }])

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/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.ArrayList;
import java.util.Arrays;
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

    pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_ecs_taskset" "example" {
  service         = exampleAwsEcsService.id
  cluster         = exampleAwsEcsCluster.id
  task_definition = exampleAwsEcsTaskDefinition.arn
  load_balancers {
    target_group_arn = exampleAwsLbTargetGroup.arn
    container_name   = "mongo"
    container_port   = 8080
  }
}

    Ignoring Changes to Scale

    You can utilize the generic resource lifecycle configuration block with ignoreChanges 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={
    "value": float(50),
})

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/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.ArrayList;
import java.util.Arrays;
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.0)
                .build())
            .build());

    }
}

    resources:
  example:
    type: aws:ecs:TaskSet
    properties:
      scale:
        value: 50

    pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_ecs_taskset" "example" {
  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,
            region: Optional[str] = None,
            launch_type: Optional[str] = None,
            load_balancers: Optional[Sequence[TaskSetLoadBalancerArgs]] = None,
            network_configuration: Optional[TaskSetNetworkConfigurationArgs] = None,
            platform_version: Optional[str] = None,
            capacity_provider_strategies: Optional[Sequence[TaskSetCapacityProviderStrategyArgs]] = None,
            scale: Optional[TaskSetScaleArgs] = None,
            force_delete: Optional[bool] = 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.


    resource "aws_ecs_task_set" "name" {
    # resource properties
}

    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.

    Constructor 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",
    Region = "string",
    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",
    CapacityProviderStrategies = new[]
    {
        new Aws.Ecs.Inputs.TaskSetCapacityProviderStrategyArgs
        {
            CapacityProvider = "string",
            Weight = 0,
            Base = 0,
        },
    },
    Scale = new Aws.Ecs.Inputs.TaskSetScaleArgs
    {
        Unit = "string",
        Value = 0.0,
    },
    ForceDelete = false,
    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"),
	Region:         pulumi.String("string"),
	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"),
	CapacityProviderStrategies: ecs.TaskSetCapacityProviderStrategyArray{
		&ecs.TaskSetCapacityProviderStrategyArgs{
			CapacityProvider: pulumi.String("string"),
			Weight:           pulumi.Int(0),
			Base:             pulumi.Int(0),
		},
	},
	Scale: &ecs.TaskSetScaleArgs{
		Unit:  pulumi.String("string"),
		Value: pulumi.Float64(0),
	},
	ForceDelete: pulumi.Bool(false),
	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"),
})

    resource "aws_ecs_task_set" "taskSetResource" {
  lifecycle {
    create_before_destroy = true
  }
  service         = "string"
  cluster         = "string"
  task_definition = "string"
  region          = "string"
  launch_type     = "string"
  load_balancers {
    container_name     = "string"
    container_port     = 0
    load_balancer_name = "string"
    target_group_arn   = "string"
  }
  network_configuration = {
    subnets          = ["string"]
    assign_public_ip = false
    security_groups  = ["string"]
  }
  platform_version = "string"
  capacity_provider_strategies {
    capacity_provider = "string"
    weight            = 0
    base              = 0
  }
  scale = {
    unit  = "string"
    value = 0
  }
  force_delete = false
  service_registries = {
    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"
}

    var taskSetResource = new TaskSet("taskSetResource", TaskSetArgs.builder()
    .service("string")
    .cluster("string")
    .taskDefinition("string")
    .region("string")
    .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")
    .capacityProviderStrategies(TaskSetCapacityProviderStrategyArgs.builder()
        .capacityProvider("string")
        .weight(0)
        .base(0)
        .build())
    .scale(TaskSetScaleArgs.builder()
        .unit("string")
        .value(0.0)
        .build())
    .forceDelete(false)
    .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",
    region="string",
    launch_type="string",
    load_balancers=[{
        "container_name": "string",
        "container_port": 0,
        "load_balancer_name": "string",
        "target_group_arn": "string",
    }],
    network_configuration={
        "subnets": ["string"],
        "assign_public_ip": False,
        "security_groups": ["string"],
    },
    platform_version="string",
    capacity_provider_strategies=[{
        "capacity_provider": "string",
        "weight": 0,
        "base": 0,
    }],
    scale={
        "unit": "string",
        "value": float(0),
    },
    force_delete=False,
    service_registries={
        "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",
    region: "string",
    launchType: "string",
    loadBalancers: [{
        containerName: "string",
        containerPort: 0,
        loadBalancerName: "string",
        targetGroupArn: "string",
    }],
    networkConfiguration: {
        subnets: ["string"],
        assignPublicIp: false,
        securityGroups: ["string"],
    },
    platformVersion: "string",
    capacityProviderStrategies: [{
        capacityProvider: "string",
        weight: 0,
        base: 0,
    }],
    scale: {
        unit: "string",
        value: 0,
    },
    forceDelete: false,
    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
    region: 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

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The TaskSet resource accepts the following input properties:

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

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    CapacityProviderStrategies List<TaskSetCapacityProviderStrategy>
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    ExternalId string
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    PlatformVersion string
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Scale TaskSetScale
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    ServiceRegistries TaskSetServiceRegistries
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    Tags Dictionary<string, string>
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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
    Short name or ARN of the cluster that hosts the service to create the task set in.
    Service string
    Short name or ARN of the ECS service.
    TaskDefinition string

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    CapacityProviderStrategies []TaskSetCapacityProviderStrategyArgs
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    ExternalId string
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    PlatformVersion string
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Scale TaskSetScaleArgs
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    ServiceRegistries TaskSetServiceRegistriesArgs
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    Tags map[string]string
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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
    Short name or ARN of the cluster that hosts the service to create the task set in.
    service string
    Short name or ARN of the ECS service.
    task_definition string

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    capacity_provider_strategies list(object)
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    external_id string
    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 string
    Launch type on which to run your service. Valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    load_balancers list(object)
    Details on load balancers that are used with a task set. Detailed below.
    network_configuration object
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platform_version string
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale object
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service_registries object
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    tags map(string)
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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 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
    Short name or ARN of the cluster that hosts the service to create the task set in.
    service String
    Short name or ARN of the ECS service.
    taskDefinition String

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    capacityProviderStrategies List<TaskSetCapacityProviderStrategy>
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    externalId String
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platformVersion String
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale TaskSetScale
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    serviceRegistries TaskSetServiceRegistries
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    tags Map<String,String>
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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
    Short name or ARN of the cluster that hosts the service to create the task set in.
    service string
    Short name or ARN of the ECS service.
    taskDefinition string

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    capacityProviderStrategies TaskSetCapacityProviderStrategy[]
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    externalId string
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platformVersion string
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale TaskSetScale
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    serviceRegistries TaskSetServiceRegistries
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    tags {[key: string]: string}
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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
    Short name or ARN of the cluster that hosts the service to create the task set in.
    service str
    Short name or ARN of the ECS service.
    task_definition str

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    capacity_provider_strategies Sequence[TaskSetCapacityProviderStrategyArgs]
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    external_id str
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platform_version str
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale TaskSetScaleArgs
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service_registries TaskSetServiceRegistriesArgs
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    tags Mapping[str, str]
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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
    Short name or ARN of the cluster that hosts the service to create the task set in.
    service String
    Short name or ARN of the ECS service.
    taskDefinition String

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    capacityProviderStrategies List<Property Map>
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    externalId String
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platformVersion String
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale Property Map
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    serviceRegistries Property Map
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    tags Map<String>
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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
    Amazon Resource Name (ARN) that identifies the task set.
    Id string
    The provider-assigned unique ID for this managed resource.
    StabilityStatus string
    Stability status. This indicates whether the task set has reached a steady state.
    Status string
    Status of the task set.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    TaskSetId string
    ID of the task set.
    Arn string
    Amazon Resource Name (ARN) that identifies the task set.
    Id string
    The provider-assigned unique ID for this managed resource.
    StabilityStatus string
    Stability status. This indicates whether the task set has reached a steady state.
    Status string
    Status of the task set.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    TaskSetId string
    ID of the task set.
    arn string
    Amazon Resource Name (ARN) that identifies the task set.
    id string
    The provider-assigned unique ID for this managed resource.
    stability_status string
    Stability status. This indicates whether the task set has reached a steady state.
    status string
    Status of the task set.
    tags_all map(string)
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    task_set_id string
    ID of the task set.
    arn String
    Amazon Resource Name (ARN) that identifies the task set.
    id String
    The provider-assigned unique ID for this managed resource.
    stabilityStatus String
    Stability status. This indicates whether the task set has reached a steady state.
    status String
    Status of the task set.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    taskSetId String
    ID of the task set.
    arn string
    Amazon Resource Name (ARN) that identifies the task set.
    id string
    The provider-assigned unique ID for this managed resource.
    stabilityStatus string
    Stability status. This indicates whether the task set has reached a steady state.
    status string
    Status of the task set.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    taskSetId string
    ID of the task set.
    arn str
    Amazon Resource Name (ARN) that identifies the task set.
    id str
    The provider-assigned unique ID for this managed resource.
    stability_status str
    Stability status. This indicates whether the task set has reached a steady state.
    status str
    Status of the task set.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    task_set_id str
    ID of the task set.
    arn String
    Amazon Resource Name (ARN) that identifies the task set.
    id String
    The provider-assigned unique ID for this managed resource.
    stabilityStatus String
    Stability status. This indicates whether the task set has reached a steady state.
    status String
    Status of the task set.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    taskSetId String
    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,
        region: 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)
    resources:  _:    type: aws:ecs:TaskSet    get:      id: ${id}
    import {
  to = aws_ecs_task_set.example
  id = "${id}"
}
    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
    Amazon Resource Name (ARN) that identifies the task set.
    CapacityProviderStrategies List<TaskSetCapacityProviderStrategy>
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    Cluster string
    Short name or ARN of the cluster that hosts the service to create the task set in.
    ExternalId string
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    PlatformVersion string
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Scale TaskSetScale
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    Service string
    Short name or ARN of the ECS service.
    ServiceRegistries TaskSetServiceRegistries
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    StabilityStatus string
    Stability status. This indicates whether the task set has reached a steady state.
    Status string
    Status of the task set.
    Tags Dictionary<string, string>
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    TaskDefinition string

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    TaskSetId string
    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
    Amazon Resource Name (ARN) that identifies the task set.
    CapacityProviderStrategies []TaskSetCapacityProviderStrategyArgs
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    Cluster string
    Short name or ARN of the cluster that hosts the service to create the task set in.
    ExternalId string
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    PlatformVersion string
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Scale TaskSetScaleArgs
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    Service string
    Short name or ARN of the ECS service.
    ServiceRegistries TaskSetServiceRegistriesArgs
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    StabilityStatus string
    Stability status. This indicates whether the task set has reached a steady state.
    Status string
    Status of the task set.
    Tags map[string]string
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    TaskDefinition string

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    TaskSetId string
    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
    Amazon Resource Name (ARN) that identifies the task set.
    capacity_provider_strategies list(object)
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster string
    Short name or ARN of the cluster that hosts the service to create the task set in.
    external_id string
    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 string
    Launch type on which to run your service. Valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.
    load_balancers list(object)
    Details on load balancers that are used with a task set. Detailed below.
    network_configuration object
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platform_version string
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale object
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service string
    Short name or ARN of the ECS service.
    service_registries object
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    stability_status string
    Stability status. This indicates whether the task set has reached a steady state.
    status string
    Status of the task set.
    tags map(string)
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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 map(string)
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    task_definition string

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    task_set_id string
    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 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
    Amazon Resource Name (ARN) that identifies the task set.
    capacityProviderStrategies List<TaskSetCapacityProviderStrategy>
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster String
    Short name or ARN of the cluster that hosts the service to create the task set in.
    externalId String
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platformVersion String
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale TaskSetScale
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service String
    Short name or ARN of the ECS service.
    serviceRegistries TaskSetServiceRegistries
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    stabilityStatus String
    Stability status. This indicates whether the task set has reached a steady state.
    status String
    Status of the task set.
    tags Map<String,String>
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    taskDefinition String

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    taskSetId String
    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
    Amazon Resource Name (ARN) that identifies the task set.
    capacityProviderStrategies TaskSetCapacityProviderStrategy[]
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster string
    Short name or ARN of the cluster that hosts the service to create the task set in.
    externalId string
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platformVersion string
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale TaskSetScale
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service string
    Short name or ARN of the ECS service.
    serviceRegistries TaskSetServiceRegistries
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    stabilityStatus string
    Stability status. This indicates whether the task set has reached a steady state.
    status string
    Status of the task set.
    tags {[key: string]: string}
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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}
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    taskDefinition string

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    taskSetId string
    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
    Amazon Resource Name (ARN) that identifies the task set.
    capacity_provider_strategies Sequence[TaskSetCapacityProviderStrategyArgs]
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster str
    Short name or ARN of the cluster that hosts the service to create the task set in.
    external_id str
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platform_version str
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale TaskSetScaleArgs
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service str
    Short name or ARN of the ECS service.
    service_registries TaskSetServiceRegistriesArgs
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    stability_status str
    Stability status. This indicates whether the task set has reached a steady state.
    status str
    Status of the task set.
    tags Mapping[str, str]
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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]
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    task_definition str

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    task_set_id str
    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
    Amazon Resource Name (ARN) that identifies the task set.
    capacityProviderStrategies List<Property Map>
    Capacity provider strategy to use for the service. Can be one or more. Defined below.
    cluster String
    Short name or ARN of the cluster that hosts the service to create the task set in.
    externalId String
    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
    Launch type on which to run your service. 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
    Network configuration for the service. Required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and not supported for other network modes. Detailed below.
    platformVersion String
    Platform version on which to run your service. Only applicable for launchType set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    scale Property Map
    Floating-point percentage of the desired number of tasks to place and keep running in the task set. Detailed below.
    service String
    Short name or ARN of the ECS service.
    serviceRegistries Property Map
    Service discovery registries for the service. The maximum number of serviceRegistries blocks is 1. Detailed below.
    stabilityStatus String
    Stability status. This indicates whether the task set has reached a steady state.
    status String
    Status of the task set.
    tags Map<String>
    Map of tags to assign to the file system. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level. If you have set copyTagsToBackups 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>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    taskDefinition String

    Family and revision (family:revision) or full ARN of the task definition to run in your service.

    The following arguments are optional:

    taskSetId String
    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
    Short name or full Amazon Resource Name (ARN) of the capacity provider.
    Weight int
    Relative percentage of the total number of launched tasks that should use the specified capacity provider.
    Base int
    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
    Short name or full Amazon Resource Name (ARN) of the capacity provider.
    Weight int
    Relative percentage of the total number of launched tasks that should use the specified capacity provider.
    Base int
    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 string
    Short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight number
    Relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base number
    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
    Short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight Integer
    Relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base Integer
    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
    Short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight number
    Relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base number
    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
    Short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight int
    Relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base int
    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
    Short name or full Amazon Resource Name (ARN) of the capacity provider.
    weight Number
    Relative percentage of the total number of launched tasks that should use the specified capacity provider.
    base Number
    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
    Name of the container to associate with the load balancer (as it appears in a container definition).
    ContainerPort int
    Port on the container to associate with the load balancer. Defaults to 0 if not specified.
    LoadBalancerName string
    Name of the ELB (Classic) to associate with the service.
    TargetGroupArn string

    ARN of the Load Balancer target group to associate with the service.

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

    ContainerName string
    Name of the container to associate with the load balancer (as it appears in a container definition).
    ContainerPort int
    Port on the container to associate with the load balancer. Defaults to 0 if not specified.
    LoadBalancerName string
    Name of the ELB (Classic) to associate with the service.
    TargetGroupArn string

    ARN of the Load Balancer target group to associate with the service.

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

    container_name string
    Name of the container to associate with the load balancer (as it appears in a container definition).
    container_port number
    Port on the container to associate with the load balancer. Defaults to 0 if not specified.
    load_balancer_name string
    Name of the ELB (Classic) to associate with the service.
    target_group_arn string

    ARN of the Load Balancer target group to associate with the service.

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

    containerName String
    Name of the container to associate with the load balancer (as it appears in a container definition).
    containerPort Integer
    Port on the container to associate with the load balancer. Defaults to 0 if not specified.
    loadBalancerName String
    Name of the ELB (Classic) to associate with the service.
    targetGroupArn String

    ARN of the Load Balancer target group to associate with the service.

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

    containerName string
    Name of the container to associate with the load balancer (as it appears in a container definition).
    containerPort number
    Port on the container to associate with the load balancer. Defaults to 0 if not specified.
    loadBalancerName string
    Name of the ELB (Classic) to associate with the service.
    targetGroupArn string

    ARN of the Load Balancer target group to associate with the service.

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

    container_name str
    Name of the container to associate with the load balancer (as it appears in a container definition).
    container_port int
    Port on the container to associate with the load balancer. Defaults to 0 if not specified.
    load_balancer_name str
    Name of the ELB (Classic) to associate with the service.
    target_group_arn str

    ARN of the Load Balancer target group to associate with the service.

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

    containerName String
    Name of the container to associate with the load balancer (as it appears in a container definition).
    containerPort Number
    Port on the container to associate with the load balancer. Defaults to 0 if not specified.
    loadBalancerName String
    Name of the ELB (Classic) to associate with the service.
    targetGroupArn String

    ARN of the Load Balancer target group to associate with the service.

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

    TaskSetNetworkConfiguration, TaskSetNetworkConfigurationArgs

    Subnets List<string>
    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.
    SecurityGroups List<string>
    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
    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.
    SecurityGroups []string
    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)
    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.
    security_groups list(string)
    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>
    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.
    securityGroups List<String>
    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[]
    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.
    securityGroups string[]
    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]
    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.
    security_groups Sequence[str]
    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>
    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.
    securityGroups List<String>
    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
    Unit of measure for the scale value. Default: PERCENT.
    Value double
    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
    Unit of measure for the scale value. Default: PERCENT.
    Value float64
    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
    Unit of measure for the scale value. Default: PERCENT.
    value number
    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
    Unit of measure for the scale value. Default: PERCENT.
    value Double
    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
    Unit of measure for the scale value. Default: PERCENT.
    value number
    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
    Unit of measure for the scale value. Default: PERCENT.
    value float
    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
    Unit of measure for the scale value. Default: PERCENT.
    value Number
    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
    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
    Container name value, already specified in the task definition, to be used for your service discovery service.
    ContainerPort int
    Port value, already specified in the task definition, to be used for your service discovery service.
    Port int
    Port value used if your Service Discovery service specified an SRV record.
    RegistryArn string
    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
    Container name value, already specified in the task definition, to be used for your service discovery service.
    ContainerPort int
    Port value, already specified in the task definition, to be used for your service discovery service.
    Port int
    Port value used if your Service Discovery service specified an SRV record.
    registry_arn string
    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 string
    Container name value, already specified in the task definition, to be used for your service discovery service.
    container_port number
    Port value, already specified in the task definition, to be used for your service discovery service.
    port number
    Port value used if your Service Discovery service specified an SRV record.
    registryArn String
    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
    Container name value, already specified in the task definition, to be used for your service discovery service.
    containerPort Integer
    Port value, already specified in the task definition, to be used for your service discovery service.
    port Integer
    Port value used if your Service Discovery service specified an SRV record.
    registryArn string
    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
    Container name value, already specified in the task definition, to be used for your service discovery service.
    containerPort number
    Port value, already specified in the task definition, to be used for your service discovery service.
    port number
    Port value used if your Service Discovery service specified an SRV record.
    registry_arn str
    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
    Container name value, already specified in the task definition, to be used for your service discovery service.
    container_port int
    Port value, already specified in the task definition, to be used for your service discovery service.
    port int
    Port value used if your Service Discovery service specified an SRV record.
    registryArn String
    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
    Container name value, already specified in the task definition, to be used for your service discovery service.
    containerPort Number
    Port value, already specified in the task definition, to be used for your service discovery service.
    port Number
    Port value used if your Service Discovery service specified an SRV record.

    Import

    Using pulumi import, import ECS Task Sets using the taskSetId, 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 aws logo
    Viewing docs for AWS v7.43.0
    published on Thursday, Aug 20, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial