AWS v6.73.0, Mar 19 25

AWS v6.73.0 published on Wednesday, Mar 19, 2025 by Pulumi

aws.ecs.Service

Explore with Pulumi AI

AWS v6.73.0 published on Wednesday, Mar 19, 2025 by Pulumi

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const mongo = new aws.ecs.Service("mongo", {
    name: "mongodb",
    cluster: fooAwsEcsCluster.id,
    taskDefinition: mongoAwsEcsTaskDefinition.arn,
    desiredCount: 3,
    iamRole: fooAwsIamRole.arn,
    orderedPlacementStrategies: [{
        type: "binpack",
        field: "cpu",
    }],
    loadBalancers: [{
        targetGroupArn: fooAwsLbTargetGroup.arn,
        containerName: "mongo",
        containerPort: 8080,
    }],
    placementConstraints: [{
        type: "memberOf",
        expression: "attribute:ecs.availability-zone in [us-west-2a, us-west-2b]",
    }],
}, {
    dependsOn: [foo],
});

import pulumi
import pulumi_aws as aws

mongo = aws.ecs.Service("mongo",
    name="mongodb",
    cluster=foo_aws_ecs_cluster["id"],
    task_definition=mongo_aws_ecs_task_definition["arn"],
    desired_count=3,
    iam_role=foo_aws_iam_role["arn"],
    ordered_placement_strategies=[{
        "type": "binpack",
        "field": "cpu",
    }],
    load_balancers=[{
        "target_group_arn": foo_aws_lb_target_group["arn"],
        "container_name": "mongo",
        "container_port": 8080,
    }],
    placement_constraints=[{
        "type": "memberOf",
        "expression": "attribute:ecs.availability-zone in [us-west-2a, us-west-2b]",
    }],
    opts = pulumi.ResourceOptions(depends_on=[foo]))

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.NewService(ctx, "mongo", &ecs.ServiceArgs{
			Name:           pulumi.String("mongodb"),
			Cluster:        pulumi.Any(fooAwsEcsCluster.Id),
			TaskDefinition: pulumi.Any(mongoAwsEcsTaskDefinition.Arn),
			DesiredCount:   pulumi.Int(3),
			IamRole:        pulumi.Any(fooAwsIamRole.Arn),
			OrderedPlacementStrategies: ecs.ServiceOrderedPlacementStrategyArray{
				&ecs.ServiceOrderedPlacementStrategyArgs{
					Type:  pulumi.String("binpack"),
					Field: pulumi.String("cpu"),
				},
			},
			LoadBalancers: ecs.ServiceLoadBalancerArray{
				&ecs.ServiceLoadBalancerArgs{
					TargetGroupArn: pulumi.Any(fooAwsLbTargetGroup.Arn),
					ContainerName:  pulumi.String("mongo"),
					ContainerPort:  pulumi.Int(8080),
				},
			},
			PlacementConstraints: ecs.ServicePlacementConstraintArray{
				&ecs.ServicePlacementConstraintArgs{
					Type:       pulumi.String("memberOf"),
					Expression: pulumi.String("attribute:ecs.availability-zone in [us-west-2a, us-west-2b]"),
				},
			},
		}, pulumi.DependsOn([]pulumi.Resource{
			foo,
		}))
		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 mongo = new Aws.Ecs.Service("mongo", new()
    {
        Name = "mongodb",
        Cluster = fooAwsEcsCluster.Id,
        TaskDefinition = mongoAwsEcsTaskDefinition.Arn,
        DesiredCount = 3,
        IamRole = fooAwsIamRole.Arn,
        OrderedPlacementStrategies = new[]
        {
            new Aws.Ecs.Inputs.ServiceOrderedPlacementStrategyArgs
            {
                Type = "binpack",
                Field = "cpu",
            },
        },
        LoadBalancers = new[]
        {
            new Aws.Ecs.Inputs.ServiceLoadBalancerArgs
            {
                TargetGroupArn = fooAwsLbTargetGroup.Arn,
                ContainerName = "mongo",
                ContainerPort = 8080,
            },
        },
        PlacementConstraints = new[]
        {
            new Aws.Ecs.Inputs.ServicePlacementConstraintArgs
            {
                Type = "memberOf",
                Expression = "attribute:ecs.availability-zone in [us-west-2a, us-west-2b]",
            },
        },
    }, new CustomResourceOptions
    {
        DependsOn =
        {
            foo,
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.Service;
import com.pulumi.aws.ecs.ServiceArgs;
import com.pulumi.aws.ecs.inputs.ServiceOrderedPlacementStrategyArgs;
import com.pulumi.aws.ecs.inputs.ServiceLoadBalancerArgs;
import com.pulumi.aws.ecs.inputs.ServicePlacementConstraintArgs;
import com.pulumi.resources.CustomResourceOptions;
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 mongo = new Service("mongo", ServiceArgs.builder()
            .name("mongodb")
            .cluster(fooAwsEcsCluster.id())
            .taskDefinition(mongoAwsEcsTaskDefinition.arn())
            .desiredCount(3)
            .iamRole(fooAwsIamRole.arn())
            .orderedPlacementStrategies(ServiceOrderedPlacementStrategyArgs.builder()
                .type("binpack")
                .field("cpu")
                .build())
            .loadBalancers(ServiceLoadBalancerArgs.builder()
                .targetGroupArn(fooAwsLbTargetGroup.arn())
                .containerName("mongo")
                .containerPort(8080)
                .build())
            .placementConstraints(ServicePlacementConstraintArgs.builder()
                .type("memberOf")
                .expression("attribute:ecs.availability-zone in [us-west-2a, us-west-2b]")
                .build())
            .build(), CustomResourceOptions.builder()
                .dependsOn(foo)
                .build());

    }
}

resources:
  mongo:
    type: aws:ecs:Service
    properties:
      name: mongodb
      cluster: ${fooAwsEcsCluster.id}
      taskDefinition: ${mongoAwsEcsTaskDefinition.arn}
      desiredCount: 3
      iamRole: ${fooAwsIamRole.arn}
      orderedPlacementStrategies:
        - type: binpack
          field: cpu
      loadBalancers:
        - targetGroupArn: ${fooAwsLbTargetGroup.arn}
          containerName: mongo
          containerPort: 8080
      placementConstraints:
        - type: memberOf
          expression: attribute:ecs.availability-zone in [us-west-2a, us-west-2b]
    options:
      dependsOn:
        - ${foo}

Ignoring Changes to Desired Count

You can use 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.Service("example", {desiredCount: 2});

import pulumi
import pulumi_aws as aws

example = aws.ecs.Service("example", desired_count=2)

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.NewService(ctx, "example", &ecs.ServiceArgs{
			DesiredCount: pulumi.Int(2),
		})
		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.Service("example", new()
    {
        DesiredCount = 2,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.Service;
import com.pulumi.aws.ecs.ServiceArgs;
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 Service("example", ServiceArgs.builder()
            .desiredCount(2)
            .build());

    }
}

resources:
  example:
    type: aws:ecs:Service
    properties:
      desiredCount: 2 # Optional: Allow external changes without this provider plan difference

Daemon Scheduling Strategy

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const bar = new aws.ecs.Service("bar", {
    name: "bar",
    cluster: foo.id,
    taskDefinition: barAwsEcsTaskDefinition.arn,
    schedulingStrategy: "DAEMON",
});

import pulumi
import pulumi_aws as aws

bar = aws.ecs.Service("bar",
    name="bar",
    cluster=foo["id"],
    task_definition=bar_aws_ecs_task_definition["arn"],
    scheduling_strategy="DAEMON")

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.NewService(ctx, "bar", &ecs.ServiceArgs{
			Name:               pulumi.String("bar"),
			Cluster:            pulumi.Any(foo.Id),
			TaskDefinition:     pulumi.Any(barAwsEcsTaskDefinition.Arn),
			SchedulingStrategy: pulumi.String("DAEMON"),
		})
		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 bar = new Aws.Ecs.Service("bar", new()
    {
        Name = "bar",
        Cluster = foo.Id,
        TaskDefinition = barAwsEcsTaskDefinition.Arn,
        SchedulingStrategy = "DAEMON",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.Service;
import com.pulumi.aws.ecs.ServiceArgs;
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 bar = new Service("bar", ServiceArgs.builder()
            .name("bar")
            .cluster(foo.id())
            .taskDefinition(barAwsEcsTaskDefinition.arn())
            .schedulingStrategy("DAEMON")
            .build());

    }
}

resources:
  bar:
    type: aws:ecs:Service
    properties:
      name: bar
      cluster: ${foo.id}
      taskDefinition: ${barAwsEcsTaskDefinition.arn}
      schedulingStrategy: DAEMON

CloudWatch Deployment Alarms

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.ecs.Service("example", {
    name: "example",
    cluster: exampleAwsEcsCluster.id,
    alarms: {
        enable: true,
        rollback: true,
        alarmNames: [exampleAwsCloudwatchMetricAlarm.alarmName],
    },
});

import pulumi
import pulumi_aws as aws

example = aws.ecs.Service("example",
    name="example",
    cluster=example_aws_ecs_cluster["id"],
    alarms={
        "enable": True,
        "rollback": True,
        "alarm_names": [example_aws_cloudwatch_metric_alarm["alarmName"]],
    })

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.NewService(ctx, "example", &ecs.ServiceArgs{
			Name:    pulumi.String("example"),
			Cluster: pulumi.Any(exampleAwsEcsCluster.Id),
			Alarms: &ecs.ServiceAlarmsArgs{
				Enable:   pulumi.Bool(true),
				Rollback: pulumi.Bool(true),
				AlarmNames: pulumi.StringArray{
					exampleAwsCloudwatchMetricAlarm.AlarmName,
				},
			},
		})
		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.Service("example", new()
    {
        Name = "example",
        Cluster = exampleAwsEcsCluster.Id,
        Alarms = new Aws.Ecs.Inputs.ServiceAlarmsArgs
        {
            Enable = true,
            Rollback = true,
            AlarmNames = new[]
            {
                exampleAwsCloudwatchMetricAlarm.AlarmName,
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.Service;
import com.pulumi.aws.ecs.ServiceArgs;
import com.pulumi.aws.ecs.inputs.ServiceAlarmsArgs;
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 Service("example", ServiceArgs.builder()
            .name("example")
            .cluster(exampleAwsEcsCluster.id())
            .alarms(ServiceAlarmsArgs.builder()
                .enable(true)
                .rollback(true)
                .alarmNames(exampleAwsCloudwatchMetricAlarm.alarmName())
                .build())
            .build());

    }
}

resources:
  example:
    type: aws:ecs:Service
    properties:
      name: example
      cluster: ${exampleAwsEcsCluster.id}
      alarms:
        enable: true
        rollback: true
        alarmNames:
          - ${exampleAwsCloudwatchMetricAlarm.alarmName}

External Deployment Controller

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.ecs.Service("example", {
    name: "example",
    cluster: exampleAwsEcsCluster.id,
    deploymentController: {
        type: "EXTERNAL",
    },
});

import pulumi
import pulumi_aws as aws

example = aws.ecs.Service("example",
    name="example",
    cluster=example_aws_ecs_cluster["id"],
    deployment_controller={
        "type": "EXTERNAL",
    })

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.NewService(ctx, "example", &ecs.ServiceArgs{
			Name:    pulumi.String("example"),
			Cluster: pulumi.Any(exampleAwsEcsCluster.Id),
			DeploymentController: &ecs.ServiceDeploymentControllerArgs{
				Type: pulumi.String("EXTERNAL"),
			},
		})
		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.Service("example", new()
    {
        Name = "example",
        Cluster = exampleAwsEcsCluster.Id,
        DeploymentController = new Aws.Ecs.Inputs.ServiceDeploymentControllerArgs
        {
            Type = "EXTERNAL",
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.Service;
import com.pulumi.aws.ecs.ServiceArgs;
import com.pulumi.aws.ecs.inputs.ServiceDeploymentControllerArgs;
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 Service("example", ServiceArgs.builder()
            .name("example")
            .cluster(exampleAwsEcsCluster.id())
            .deploymentController(ServiceDeploymentControllerArgs.builder()
                .type("EXTERNAL")
                .build())
            .build());

    }
}

resources:
  example:
    type: aws:ecs:Service
    properties:
      name: example
      cluster: ${exampleAwsEcsCluster.id}
      deploymentController:
        type: EXTERNAL

Redeploy Service On Every Apply

The key used with triggers is arbitrary.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.ecs.Service("example", {
    forceNewDeployment: true,
    triggers: {
        redeployment: "plantimestamp()",
    },
});

import pulumi
import pulumi_aws as aws

example = aws.ecs.Service("example",
    force_new_deployment=True,
    triggers={
        "redeployment": "plantimestamp()",
    })

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.NewService(ctx, "example", &ecs.ServiceArgs{
			ForceNewDeployment: pulumi.Bool(true),
			Triggers: pulumi.StringMap{
				"redeployment": pulumi.String("plantimestamp()"),
			},
		})
		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.Service("example", new()
    {
        ForceNewDeployment = true,
        Triggers = 
        {
            { "redeployment", "plantimestamp()" },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.Service;
import com.pulumi.aws.ecs.ServiceArgs;
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 Service("example", ServiceArgs.builder()
            .forceNewDeployment(true)
            .triggers(Map.of("redeployment", "plantimestamp()"))
            .build());

    }
}

resources:
  example:
    type: aws:ecs:Service
    properties:
      forceNewDeployment: true
      triggers:
        redeployment: plantimestamp()

Create Service Resource

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

Constructor syntax

new Service(name: string, args?: ServiceArgs, opts?: CustomResourceOptions);

@overload
def Service(resource_name: str,
            args: Optional[ServiceArgs] = None,
            opts: Optional[ResourceOptions] = None)

@overload
def Service(resource_name: str,
            opts: Optional[ResourceOptions] = None,
            alarms: Optional[ServiceAlarmsArgs] = None,
            availability_zone_rebalancing: Optional[str] = None,
            capacity_provider_strategies: Optional[Sequence[ServiceCapacityProviderStrategyArgs]] = None,
            cluster: Optional[str] = None,
            deployment_circuit_breaker: Optional[ServiceDeploymentCircuitBreakerArgs] = None,
            deployment_controller: Optional[ServiceDeploymentControllerArgs] = None,
            deployment_maximum_percent: Optional[int] = None,
            deployment_minimum_healthy_percent: Optional[int] = None,
            desired_count: Optional[int] = None,
            enable_ecs_managed_tags: Optional[bool] = None,
            enable_execute_command: Optional[bool] = None,
            force_delete: Optional[bool] = None,
            force_new_deployment: Optional[bool] = None,
            health_check_grace_period_seconds: Optional[int] = None,
            iam_role: Optional[str] = None,
            launch_type: Optional[str] = None,
            load_balancers: Optional[Sequence[ServiceLoadBalancerArgs]] = None,
            name: Optional[str] = None,
            network_configuration: Optional[ServiceNetworkConfigurationArgs] = None,
            ordered_placement_strategies: Optional[Sequence[ServiceOrderedPlacementStrategyArgs]] = None,
            placement_constraints: Optional[Sequence[ServicePlacementConstraintArgs]] = None,
            platform_version: Optional[str] = None,
            propagate_tags: Optional[str] = None,
            scheduling_strategy: Optional[str] = None,
            service_connect_configuration: Optional[ServiceServiceConnectConfigurationArgs] = None,
            service_registries: Optional[ServiceServiceRegistriesArgs] = None,
            tags: Optional[Mapping[str, str]] = None,
            task_definition: Optional[str] = None,
            triggers: Optional[Mapping[str, str]] = None,
            volume_configuration: Optional[ServiceVolumeConfigurationArgs] = None,
            vpc_lattice_configurations: Optional[Sequence[ServiceVpcLatticeConfigurationArgs]] = None,
            wait_for_steady_state: Optional[bool] = None)

func NewService(ctx *Context, name string, args *ServiceArgs, opts ...ResourceOption) (*Service, error)

public Service(string name, ServiceArgs? args = null, CustomResourceOptions? opts = null)

public Service(String name, ServiceArgs args)
public Service(String name, ServiceArgs args, CustomResourceOptions options)

type: aws:ecs:Service
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 ServiceArgs: 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 ServiceArgs: 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 ServiceArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args ServiceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args ServiceArgs: 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 awsServiceResource = new Aws.Ecs.Service("awsServiceResource", new()
{
    Alarms = new Aws.Ecs.Inputs.ServiceAlarmsArgs
    {
        AlarmNames = new[]
        {
            "string",
        },
        Enable = false,
        Rollback = false,
    },
    AvailabilityZoneRebalancing = "string",
    CapacityProviderStrategies = new[]
    {
        new Aws.Ecs.Inputs.ServiceCapacityProviderStrategyArgs
        {
            CapacityProvider = "string",
            Base = 0,
            Weight = 0,
        },
    },
    Cluster = "string",
    DeploymentCircuitBreaker = new Aws.Ecs.Inputs.ServiceDeploymentCircuitBreakerArgs
    {
        Enable = false,
        Rollback = false,
    },
    DeploymentController = new Aws.Ecs.Inputs.ServiceDeploymentControllerArgs
    {
        Type = "string",
    },
    DeploymentMaximumPercent = 0,
    DeploymentMinimumHealthyPercent = 0,
    DesiredCount = 0,
    EnableEcsManagedTags = false,
    EnableExecuteCommand = false,
    ForceDelete = false,
    ForceNewDeployment = false,
    HealthCheckGracePeriodSeconds = 0,
    IamRole = "string",
    LaunchType = "string",
    LoadBalancers = new[]
    {
        new Aws.Ecs.Inputs.ServiceLoadBalancerArgs
        {
            ContainerName = "string",
            ContainerPort = 0,
            ElbName = "string",
            TargetGroupArn = "string",
        },
    },
    Name = "string",
    NetworkConfiguration = new Aws.Ecs.Inputs.ServiceNetworkConfigurationArgs
    {
        Subnets = new[]
        {
            "string",
        },
        AssignPublicIp = false,
        SecurityGroups = new[]
        {
            "string",
        },
    },
    OrderedPlacementStrategies = new[]
    {
        new Aws.Ecs.Inputs.ServiceOrderedPlacementStrategyArgs
        {
            Type = "string",
            Field = "string",
        },
    },
    PlacementConstraints = new[]
    {
        new Aws.Ecs.Inputs.ServicePlacementConstraintArgs
        {
            Type = "string",
            Expression = "string",
        },
    },
    PlatformVersion = "string",
    PropagateTags = "string",
    SchedulingStrategy = "string",
    ServiceConnectConfiguration = new Aws.Ecs.Inputs.ServiceServiceConnectConfigurationArgs
    {
        Enabled = false,
        LogConfiguration = new Aws.Ecs.Inputs.ServiceServiceConnectConfigurationLogConfigurationArgs
        {
            LogDriver = "string",
            Options = 
            {
                { "string", "string" },
            },
            SecretOptions = new[]
            {
                new Aws.Ecs.Inputs.ServiceServiceConnectConfigurationLogConfigurationSecretOptionArgs
                {
                    Name = "string",
                    ValueFrom = "string",
                },
            },
        },
        Namespace = "string",
        Services = new[]
        {
            new Aws.Ecs.Inputs.ServiceServiceConnectConfigurationServiceArgs
            {
                PortName = "string",
                ClientAlias = new[]
                {
                    new Aws.Ecs.Inputs.ServiceServiceConnectConfigurationServiceClientAliasArgs
                    {
                        Port = 0,
                        DnsName = "string",
                    },
                },
                DiscoveryName = "string",
                IngressPortOverride = 0,
                Timeout = new Aws.Ecs.Inputs.ServiceServiceConnectConfigurationServiceTimeoutArgs
                {
                    IdleTimeoutSeconds = 0,
                    PerRequestTimeoutSeconds = 0,
                },
                Tls = new Aws.Ecs.Inputs.ServiceServiceConnectConfigurationServiceTlsArgs
                {
                    IssuerCertAuthority = new Aws.Ecs.Inputs.ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthorityArgs
                    {
                        AwsPcaAuthorityArn = "string",
                    },
                    KmsKey = "string",
                    RoleArn = "string",
                },
            },
        },
    },
    ServiceRegistries = new Aws.Ecs.Inputs.ServiceServiceRegistriesArgs
    {
        RegistryArn = "string",
        ContainerName = "string",
        ContainerPort = 0,
        Port = 0,
    },
    Tags = 
    {
        { "string", "string" },
    },
    TaskDefinition = "string",
    Triggers = 
    {
        { "string", "string" },
    },
    VolumeConfiguration = new Aws.Ecs.Inputs.ServiceVolumeConfigurationArgs
    {
        ManagedEbsVolume = new Aws.Ecs.Inputs.ServiceVolumeConfigurationManagedEbsVolumeArgs
        {
            RoleArn = "string",
            Encrypted = false,
            FileSystemType = "string",
            Iops = 0,
            KmsKeyId = "string",
            SizeInGb = 0,
            SnapshotId = "string",
            TagSpecifications = new[]
            {
                new Aws.Ecs.Inputs.ServiceVolumeConfigurationManagedEbsVolumeTagSpecificationArgs
                {
                    ResourceType = "string",
                    PropagateTags = "string",
                    Tags = 
                    {
                        { "string", "string" },
                    },
                },
            },
            Throughput = 0,
            VolumeType = "string",
        },
        Name = "string",
    },
    VpcLatticeConfigurations = new[]
    {
        new Aws.Ecs.Inputs.ServiceVpcLatticeConfigurationArgs
        {
            PortName = "string",
            RoleArn = "string",
            TargetGroupArn = "string",
        },
    },
    WaitForSteadyState = false,
});

example, err := ecs.NewService(ctx, "awsServiceResource", &ecs.ServiceArgs{
	Alarms: &ecs.ServiceAlarmsArgs{
		AlarmNames: pulumi.StringArray{
			pulumi.String("string"),
		},
		Enable:   pulumi.Bool(false),
		Rollback: pulumi.Bool(false),
	},
	AvailabilityZoneRebalancing: pulumi.String("string"),
	CapacityProviderStrategies: ecs.ServiceCapacityProviderStrategyArray{
		&ecs.ServiceCapacityProviderStrategyArgs{
			CapacityProvider: pulumi.String("string"),
			Base:             pulumi.Int(0),
			Weight:           pulumi.Int(0),
		},
	},
	Cluster: pulumi.String("string"),
	DeploymentCircuitBreaker: &ecs.ServiceDeploymentCircuitBreakerArgs{
		Enable:   pulumi.Bool(false),
		Rollback: pulumi.Bool(false),
	},
	DeploymentController: &ecs.ServiceDeploymentControllerArgs{
		Type: pulumi.String("string"),
	},
	DeploymentMaximumPercent:        pulumi.Int(0),
	DeploymentMinimumHealthyPercent: pulumi.Int(0),
	DesiredCount:                    pulumi.Int(0),
	EnableEcsManagedTags:            pulumi.Bool(false),
	EnableExecuteCommand:            pulumi.Bool(false),
	ForceDelete:                     pulumi.Bool(false),
	ForceNewDeployment:              pulumi.Bool(false),
	HealthCheckGracePeriodSeconds:   pulumi.Int(0),
	IamRole:                         pulumi.String("string"),
	LaunchType:                      pulumi.String("string"),
	LoadBalancers: ecs.ServiceLoadBalancerArray{
		&ecs.ServiceLoadBalancerArgs{
			ContainerName:  pulumi.String("string"),
			ContainerPort:  pulumi.Int(0),
			ElbName:        pulumi.String("string"),
			TargetGroupArn: pulumi.String("string"),
		},
	},
	Name: pulumi.String("string"),
	NetworkConfiguration: &ecs.ServiceNetworkConfigurationArgs{
		Subnets: pulumi.StringArray{
			pulumi.String("string"),
		},
		AssignPublicIp: pulumi.Bool(false),
		SecurityGroups: pulumi.StringArray{
			pulumi.String("string"),
		},
	},
	OrderedPlacementStrategies: ecs.ServiceOrderedPlacementStrategyArray{
		&ecs.ServiceOrderedPlacementStrategyArgs{
			Type:  pulumi.String("string"),
			Field: pulumi.String("string"),
		},
	},
	PlacementConstraints: ecs.ServicePlacementConstraintArray{
		&ecs.ServicePlacementConstraintArgs{
			Type:       pulumi.String("string"),
			Expression: pulumi.String("string"),
		},
	},
	PlatformVersion:    pulumi.String("string"),
	PropagateTags:      pulumi.String("string"),
	SchedulingStrategy: pulumi.String("string"),
	ServiceConnectConfiguration: &ecs.ServiceServiceConnectConfigurationArgs{
		Enabled: pulumi.Bool(false),
		LogConfiguration: &ecs.ServiceServiceConnectConfigurationLogConfigurationArgs{
			LogDriver: pulumi.String("string"),
			Options: pulumi.StringMap{
				"string": pulumi.String("string"),
			},
			SecretOptions: ecs.ServiceServiceConnectConfigurationLogConfigurationSecretOptionArray{
				&ecs.ServiceServiceConnectConfigurationLogConfigurationSecretOptionArgs{
					Name:      pulumi.String("string"),
					ValueFrom: pulumi.String("string"),
				},
			},
		},
		Namespace: pulumi.String("string"),
		Services: ecs.ServiceServiceConnectConfigurationServiceArray{
			&ecs.ServiceServiceConnectConfigurationServiceArgs{
				PortName: pulumi.String("string"),
				ClientAlias: ecs.ServiceServiceConnectConfigurationServiceClientAliasArray{
					&ecs.ServiceServiceConnectConfigurationServiceClientAliasArgs{
						Port:    pulumi.Int(0),
						DnsName: pulumi.String("string"),
					},
				},
				DiscoveryName:       pulumi.String("string"),
				IngressPortOverride: pulumi.Int(0),
				Timeout: &ecs.ServiceServiceConnectConfigurationServiceTimeoutArgs{
					IdleTimeoutSeconds:       pulumi.Int(0),
					PerRequestTimeoutSeconds: pulumi.Int(0),
				},
				Tls: &ecs.ServiceServiceConnectConfigurationServiceTlsArgs{
					IssuerCertAuthority: &ecs.ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthorityArgs{
						AwsPcaAuthorityArn: pulumi.String("string"),
					},
					KmsKey:  pulumi.String("string"),
					RoleArn: pulumi.String("string"),
				},
			},
		},
	},
	ServiceRegistries: &ecs.ServiceServiceRegistriesArgs{
		RegistryArn:   pulumi.String("string"),
		ContainerName: pulumi.String("string"),
		ContainerPort: pulumi.Int(0),
		Port:          pulumi.Int(0),
	},
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	TaskDefinition: pulumi.String("string"),
	Triggers: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	VolumeConfiguration: &ecs.ServiceVolumeConfigurationArgs{
		ManagedEbsVolume: &ecs.ServiceVolumeConfigurationManagedEbsVolumeArgs{
			RoleArn:        pulumi.String("string"),
			Encrypted:      pulumi.Bool(false),
			FileSystemType: pulumi.String("string"),
			Iops:           pulumi.Int(0),
			KmsKeyId:       pulumi.String("string"),
			SizeInGb:       pulumi.Int(0),
			SnapshotId:     pulumi.String("string"),
			TagSpecifications: ecs.ServiceVolumeConfigurationManagedEbsVolumeTagSpecificationArray{
				&ecs.ServiceVolumeConfigurationManagedEbsVolumeTagSpecificationArgs{
					ResourceType:  pulumi.String("string"),
					PropagateTags: pulumi.String("string"),
					Tags: pulumi.StringMap{
						"string": pulumi.String("string"),
					},
				},
			},
			Throughput: pulumi.Int(0),
			VolumeType: pulumi.String("string"),
		},
		Name: pulumi.String("string"),
	},
	VpcLatticeConfigurations: ecs.ServiceVpcLatticeConfigurationArray{
		&ecs.ServiceVpcLatticeConfigurationArgs{
			PortName:       pulumi.String("string"),
			RoleArn:        pulumi.String("string"),
			TargetGroupArn: pulumi.String("string"),
		},
	},
	WaitForSteadyState: pulumi.Bool(false),
})

var awsServiceResource = new Service("awsServiceResource", ServiceArgs.builder()
    .alarms(ServiceAlarmsArgs.builder()
        .alarmNames("string")
        .enable(false)
        .rollback(false)
        .build())
    .availabilityZoneRebalancing("string")
    .capacityProviderStrategies(ServiceCapacityProviderStrategyArgs.builder()
        .capacityProvider("string")
        .base(0)
        .weight(0)
        .build())
    .cluster("string")
    .deploymentCircuitBreaker(ServiceDeploymentCircuitBreakerArgs.builder()
        .enable(false)
        .rollback(false)
        .build())
    .deploymentController(ServiceDeploymentControllerArgs.builder()
        .type("string")
        .build())
    .deploymentMaximumPercent(0)
    .deploymentMinimumHealthyPercent(0)
    .desiredCount(0)
    .enableEcsManagedTags(false)
    .enableExecuteCommand(false)
    .forceDelete(false)
    .forceNewDeployment(false)
    .healthCheckGracePeriodSeconds(0)
    .iamRole("string")
    .launchType("string")
    .loadBalancers(ServiceLoadBalancerArgs.builder()
        .containerName("string")
        .containerPort(0)
        .elbName("string")
        .targetGroupArn("string")
        .build())
    .name("string")
    .networkConfiguration(ServiceNetworkConfigurationArgs.builder()
        .subnets("string")
        .assignPublicIp(false)
        .securityGroups("string")
        .build())
    .orderedPlacementStrategies(ServiceOrderedPlacementStrategyArgs.builder()
        .type("string")
        .field("string")
        .build())
    .placementConstraints(ServicePlacementConstraintArgs.builder()
        .type("string")
        .expression("string")
        .build())
    .platformVersion("string")
    .propagateTags("string")
    .schedulingStrategy("string")
    .serviceConnectConfiguration(ServiceServiceConnectConfigurationArgs.builder()
        .enabled(false)
        .logConfiguration(ServiceServiceConnectConfigurationLogConfigurationArgs.builder()
            .logDriver("string")
            .options(Map.of("string", "string"))
            .secretOptions(ServiceServiceConnectConfigurationLogConfigurationSecretOptionArgs.builder()
                .name("string")
                .valueFrom("string")
                .build())
            .build())
        .namespace("string")
        .services(ServiceServiceConnectConfigurationServiceArgs.builder()
            .portName("string")
            .clientAlias(ServiceServiceConnectConfigurationServiceClientAliasArgs.builder()
                .port(0)
                .dnsName("string")
                .build())
            .discoveryName("string")
            .ingressPortOverride(0)
            .timeout(ServiceServiceConnectConfigurationServiceTimeoutArgs.builder()
                .idleTimeoutSeconds(0)
                .perRequestTimeoutSeconds(0)
                .build())
            .tls(ServiceServiceConnectConfigurationServiceTlsArgs.builder()
                .issuerCertAuthority(ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthorityArgs.builder()
                    .awsPcaAuthorityArn("string")
                    .build())
                .kmsKey("string")
                .roleArn("string")
                .build())
            .build())
        .build())
    .serviceRegistries(ServiceServiceRegistriesArgs.builder()
        .registryArn("string")
        .containerName("string")
        .containerPort(0)
        .port(0)
        .build())
    .tags(Map.of("string", "string"))
    .taskDefinition("string")
    .triggers(Map.of("string", "string"))
    .volumeConfiguration(ServiceVolumeConfigurationArgs.builder()
        .managedEbsVolume(ServiceVolumeConfigurationManagedEbsVolumeArgs.builder()
            .roleArn("string")
            .encrypted(false)
            .fileSystemType("string")
            .iops(0)
            .kmsKeyId("string")
            .sizeInGb(0)
            .snapshotId("string")
            .tagSpecifications(ServiceVolumeConfigurationManagedEbsVolumeTagSpecificationArgs.builder()
                .resourceType("string")
                .propagateTags("string")
                .tags(Map.of("string", "string"))
                .build())
            .throughput(0)
            .volumeType("string")
            .build())
        .name("string")
        .build())
    .vpcLatticeConfigurations(ServiceVpcLatticeConfigurationArgs.builder()
        .portName("string")
        .roleArn("string")
        .targetGroupArn("string")
        .build())
    .waitForSteadyState(false)
    .build());

aws_service_resource = aws.ecs.Service("awsServiceResource",
    alarms={
        "alarm_names": ["string"],
        "enable": False,
        "rollback": False,
    },
    availability_zone_rebalancing="string",
    capacity_provider_strategies=[{
        "capacity_provider": "string",
        "base": 0,
        "weight": 0,
    }],
    cluster="string",
    deployment_circuit_breaker={
        "enable": False,
        "rollback": False,
    },
    deployment_controller={
        "type": "string",
    },
    deployment_maximum_percent=0,
    deployment_minimum_healthy_percent=0,
    desired_count=0,
    enable_ecs_managed_tags=False,
    enable_execute_command=False,
    force_delete=False,
    force_new_deployment=False,
    health_check_grace_period_seconds=0,
    iam_role="string",
    launch_type="string",
    load_balancers=[{
        "container_name": "string",
        "container_port": 0,
        "elb_name": "string",
        "target_group_arn": "string",
    }],
    name="string",
    network_configuration={
        "subnets": ["string"],
        "assign_public_ip": False,
        "security_groups": ["string"],
    },
    ordered_placement_strategies=[{
        "type": "string",
        "field": "string",
    }],
    placement_constraints=[{
        "type": "string",
        "expression": "string",
    }],
    platform_version="string",
    propagate_tags="string",
    scheduling_strategy="string",
    service_connect_configuration={
        "enabled": False,
        "log_configuration": {
            "log_driver": "string",
            "options": {
                "string": "string",
            },
            "secret_options": [{
                "name": "string",
                "value_from": "string",
            }],
        },
        "namespace": "string",
        "services": [{
            "port_name": "string",
            "client_alias": [{
                "port": 0,
                "dns_name": "string",
            }],
            "discovery_name": "string",
            "ingress_port_override": 0,
            "timeout": {
                "idle_timeout_seconds": 0,
                "per_request_timeout_seconds": 0,
            },
            "tls": {
                "issuer_cert_authority": {
                    "aws_pca_authority_arn": "string",
                },
                "kms_key": "string",
                "role_arn": "string",
            },
        }],
    },
    service_registries={
        "registry_arn": "string",
        "container_name": "string",
        "container_port": 0,
        "port": 0,
    },
    tags={
        "string": "string",
    },
    task_definition="string",
    triggers={
        "string": "string",
    },
    volume_configuration={
        "managed_ebs_volume": {
            "role_arn": "string",
            "encrypted": False,
            "file_system_type": "string",
            "iops": 0,
            "kms_key_id": "string",
            "size_in_gb": 0,
            "snapshot_id": "string",
            "tag_specifications": [{
                "resource_type": "string",
                "propagate_tags": "string",
                "tags": {
                    "string": "string",
                },
            }],
            "throughput": 0,
            "volume_type": "string",
        },
        "name": "string",
    },
    vpc_lattice_configurations=[{
        "port_name": "string",
        "role_arn": "string",
        "target_group_arn": "string",
    }],
    wait_for_steady_state=False)

const awsServiceResource = new aws.ecs.Service("awsServiceResource", {
    alarms: {
        alarmNames: ["string"],
        enable: false,
        rollback: false,
    },
    availabilityZoneRebalancing: "string",
    capacityProviderStrategies: [{
        capacityProvider: "string",
        base: 0,
        weight: 0,
    }],
    cluster: "string",
    deploymentCircuitBreaker: {
        enable: false,
        rollback: false,
    },
    deploymentController: {
        type: "string",
    },
    deploymentMaximumPercent: 0,
    deploymentMinimumHealthyPercent: 0,
    desiredCount: 0,
    enableEcsManagedTags: false,
    enableExecuteCommand: false,
    forceDelete: false,
    forceNewDeployment: false,
    healthCheckGracePeriodSeconds: 0,
    iamRole: "string",
    launchType: "string",
    loadBalancers: [{
        containerName: "string",
        containerPort: 0,
        elbName: "string",
        targetGroupArn: "string",
    }],
    name: "string",
    networkConfiguration: {
        subnets: ["string"],
        assignPublicIp: false,
        securityGroups: ["string"],
    },
    orderedPlacementStrategies: [{
        type: "string",
        field: "string",
    }],
    placementConstraints: [{
        type: "string",
        expression: "string",
    }],
    platformVersion: "string",
    propagateTags: "string",
    schedulingStrategy: "string",
    serviceConnectConfiguration: {
        enabled: false,
        logConfiguration: {
            logDriver: "string",
            options: {
                string: "string",
            },
            secretOptions: [{
                name: "string",
                valueFrom: "string",
            }],
        },
        namespace: "string",
        services: [{
            portName: "string",
            clientAlias: [{
                port: 0,
                dnsName: "string",
            }],
            discoveryName: "string",
            ingressPortOverride: 0,
            timeout: {
                idleTimeoutSeconds: 0,
                perRequestTimeoutSeconds: 0,
            },
            tls: {
                issuerCertAuthority: {
                    awsPcaAuthorityArn: "string",
                },
                kmsKey: "string",
                roleArn: "string",
            },
        }],
    },
    serviceRegistries: {
        registryArn: "string",
        containerName: "string",
        containerPort: 0,
        port: 0,
    },
    tags: {
        string: "string",
    },
    taskDefinition: "string",
    triggers: {
        string: "string",
    },
    volumeConfiguration: {
        managedEbsVolume: {
            roleArn: "string",
            encrypted: false,
            fileSystemType: "string",
            iops: 0,
            kmsKeyId: "string",
            sizeInGb: 0,
            snapshotId: "string",
            tagSpecifications: [{
                resourceType: "string",
                propagateTags: "string",
                tags: {
                    string: "string",
                },
            }],
            throughput: 0,
            volumeType: "string",
        },
        name: "string",
    },
    vpcLatticeConfigurations: [{
        portName: "string",
        roleArn: "string",
        targetGroupArn: "string",
    }],
    waitForSteadyState: false,
});

type: aws:ecs:Service
properties:
    alarms:
        alarmNames:
            - string
        enable: false
        rollback: false
    availabilityZoneRebalancing: string
    capacityProviderStrategies:
        - base: 0
          capacityProvider: string
          weight: 0
    cluster: string
    deploymentCircuitBreaker:
        enable: false
        rollback: false
    deploymentController:
        type: string
    deploymentMaximumPercent: 0
    deploymentMinimumHealthyPercent: 0
    desiredCount: 0
    enableEcsManagedTags: false
    enableExecuteCommand: false
    forceDelete: false
    forceNewDeployment: false
    healthCheckGracePeriodSeconds: 0
    iamRole: string
    launchType: string
    loadBalancers:
        - containerName: string
          containerPort: 0
          elbName: string
          targetGroupArn: string
    name: string
    networkConfiguration:
        assignPublicIp: false
        securityGroups:
            - string
        subnets:
            - string
    orderedPlacementStrategies:
        - field: string
          type: string
    placementConstraints:
        - expression: string
          type: string
    platformVersion: string
    propagateTags: string
    schedulingStrategy: string
    serviceConnectConfiguration:
        enabled: false
        logConfiguration:
            logDriver: string
            options:
                string: string
            secretOptions:
                - name: string
                  valueFrom: string
        namespace: string
        services:
            - clientAlias:
                - dnsName: string
                  port: 0
              discoveryName: string
              ingressPortOverride: 0
              portName: string
              timeout:
                idleTimeoutSeconds: 0
                perRequestTimeoutSeconds: 0
              tls:
                issuerCertAuthority:
                    awsPcaAuthorityArn: string
                kmsKey: string
                roleArn: string
    serviceRegistries:
        containerName: string
        containerPort: 0
        port: 0
        registryArn: string
    tags:
        string: string
    taskDefinition: string
    triggers:
        string: string
    volumeConfiguration:
        managedEbsVolume:
            encrypted: false
            fileSystemType: string
            iops: 0
            kmsKeyId: string
            roleArn: string
            sizeInGb: 0
            snapshotId: string
            tagSpecifications:
                - propagateTags: string
                  resourceType: string
                  tags:
                    string: string
            throughput: 0
            volumeType: string
        name: string
    vpcLatticeConfigurations:
        - portName: string
          roleArn: string
          targetGroupArn: string
    waitForSteadyState: false

Service 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 Service resource accepts the following input properties:

Alarms ServiceAlarms

Information about the CloudWatch alarms. See below.

AvailabilityZoneRebalancing string

ECS automatically redistributes tasks within a service across Availability Zones (AZs) to mitigate the risk of impaired application availability due to underlying infrastructure failures and task lifecycle activities. The valid values are ENABLED and DISABLED. Defaults to DISABLED.

CapacityProviderStrategies List<ServiceCapacityProviderStrategy>

Capacity provider strategies to use for the service. Can be one or more. These can be updated without destroying and recreating the service only if force_new_deployment = true and not changing from 0 capacity_provider_strategy blocks to greater than 0, or vice versa. See below. Conflicts with launch_type.

Cluster string

ARN of an ECS cluster.

DeploymentCircuitBreaker ServiceDeploymentCircuitBreaker

Configuration block for deployment circuit breaker. See below.

DeploymentController ServiceDeploymentController

Configuration block for deployment controller configuration. See below.

DeploymentMaximumPercent int

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

DeploymentMinimumHealthyPercent int

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

DesiredCount int

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

EnableEcsManagedTags bool

Whether to enable Amazon ECS managed tags for the tasks within the service.

EnableExecuteCommand bool

Whether to enable Amazon ECS Exec for the tasks within the service.

ForceDelete bool

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

ForceNewDeployment bool

Enable to force a new task deployment of the service. This can be used to update tasks to use a newer Docker image with same image/tag combination (e.g., myimage:latest), roll Fargate tasks onto a newer platform version, or immediately deploy ordered_placement_strategy and placement_constraints updates. When using the forceNewDeployment property you also need to configure the triggers property.

HealthCheckGracePeriodSeconds int

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

IamRole string

ARN of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is required if you are using a load balancer with your service, but only if your task definition does not use the awsvpc network mode. If using awsvpc network mode, do not specify this role. If your account has already created the Amazon ECS service-linked role, that role is used by default for your service unless you specify a role here.

LaunchType string

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

LoadBalancers List<ServiceLoadBalancer>

Configuration block for load balancers. See below.

Name string

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

NetworkConfiguration ServiceNetworkConfiguration

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. See below.

OrderedPlacementStrategies List<ServiceOrderedPlacementStrategy>

Service level strategy rules that are taken into consideration during task placement. List from top to bottom in order of precedence. Updates to this configuration will take effect next task deployment unless force_new_deployment is enabled. The maximum number of ordered_placement_strategy blocks is 5. See below.

PlacementConstraints List<ServicePlacementConstraint>

Rules that are taken into consideration during task placement. Updates to this configuration will take effect next task deployment unless force_new_deployment is enabled. Maximum number of placement_constraints is 10. See below.

PlatformVersion string

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.

PropagateTags string

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

SchedulingStrategy string

Scheduling strategy to use for the service. The valid values are REPLICA and DAEMON. Defaults to REPLICA. Note that Tasks using the Fargate launch type or the CODE_DEPLOY or EXTERNAL deployment controller types don't support the DAEMON scheduling strategy.

ServiceConnectConfiguration ServiceServiceConnectConfiguration

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

ServiceRegistries ServiceServiceRegistries

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

Tags Dictionary<string, string>

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

TaskDefinition string

Family and revision (family:revision) or full ARN of the task definition that you want to run in your service. Required unless using the EXTERNAL deployment controller. If a revision is not specified, the latest ACTIVE revision is used.

Triggers Dictionary<string, string>

Map of arbitrary keys and values that, when changed, will trigger an in-place update (redeployment). Useful with "plantimestamp()". When using the triggers property you also need to set the forceNewDeployment property to True.

VolumeConfiguration ServiceVolumeConfiguration

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

VpcLatticeConfigurations List<ServiceVpcLatticeConfiguration>

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

WaitForSteadyState bool

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

Alarms ServiceAlarmsArgs

Information about the CloudWatch alarms. See below.

AvailabilityZoneRebalancing string

CapacityProviderStrategies []ServiceCapacityProviderStrategyArgs

Cluster string

ARN of an ECS cluster.

DeploymentCircuitBreaker ServiceDeploymentCircuitBreakerArgs

Configuration block for deployment circuit breaker. See below.

DeploymentController ServiceDeploymentControllerArgs

Configuration block for deployment controller configuration. See below.

DeploymentMaximumPercent int

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

DeploymentMinimumHealthyPercent int

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

DesiredCount int

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

EnableEcsManagedTags bool

Whether to enable Amazon ECS managed tags for the tasks within the service.

EnableExecuteCommand bool

Whether to enable Amazon ECS Exec for the tasks within the service.

ForceDelete bool

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

ForceNewDeployment bool

HealthCheckGracePeriodSeconds int

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

IamRole string

LaunchType string

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

LoadBalancers []ServiceLoadBalancerArgs

Configuration block for load balancers. See below.

Name string

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

NetworkConfiguration ServiceNetworkConfigurationArgs

OrderedPlacementStrategies []ServiceOrderedPlacementStrategyArgs

PlacementConstraints []ServicePlacementConstraintArgs

PlatformVersion string

PropagateTags string

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

SchedulingStrategy string

ServiceConnectConfiguration ServiceServiceConnectConfigurationArgs

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

ServiceRegistries ServiceServiceRegistriesArgs

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

Tags map[string]string

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

TaskDefinition string

Triggers map[string]string

VolumeConfiguration ServiceVolumeConfigurationArgs

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

VpcLatticeConfigurations []ServiceVpcLatticeConfigurationArgs

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

WaitForSteadyState bool

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

alarms ServiceAlarms

Information about the CloudWatch alarms. See below.

availabilityZoneRebalancing String

capacityProviderStrategies List<ServiceCapacityProviderStrategy>

cluster String

ARN of an ECS cluster.

deploymentCircuitBreaker ServiceDeploymentCircuitBreaker

Configuration block for deployment circuit breaker. See below.

deploymentController ServiceDeploymentController

Configuration block for deployment controller configuration. See below.

deploymentMaximumPercent Integer

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

deploymentMinimumHealthyPercent Integer

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

desiredCount Integer

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

enableEcsManagedTags Boolean

Whether to enable Amazon ECS managed tags for the tasks within the service.

enableExecuteCommand Boolean

Whether to enable Amazon ECS Exec for the tasks within the service.

forceDelete Boolean

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

forceNewDeployment Boolean

healthCheckGracePeriodSeconds Integer

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

iamRole String

launchType String

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

loadBalancers List<ServiceLoadBalancer>

Configuration block for load balancers. See below.

name String

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

networkConfiguration ServiceNetworkConfiguration

orderedPlacementStrategies List<ServiceOrderedPlacementStrategy>

placementConstraints List<ServicePlacementConstraint>

platformVersion String

propagateTags String

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

schedulingStrategy String

serviceConnectConfiguration ServiceServiceConnectConfiguration

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

serviceRegistries ServiceServiceRegistries

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

tags Map<String,String>

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

taskDefinition String

triggers Map<String,String>

volumeConfiguration ServiceVolumeConfiguration

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

vpcLatticeConfigurations List<ServiceVpcLatticeConfiguration>

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

waitForSteadyState Boolean

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

alarms ServiceAlarms

Information about the CloudWatch alarms. See below.

availabilityZoneRebalancing string

capacityProviderStrategies ServiceCapacityProviderStrategy[]

cluster string

ARN of an ECS cluster.

deploymentCircuitBreaker ServiceDeploymentCircuitBreaker

Configuration block for deployment circuit breaker. See below.

deploymentController ServiceDeploymentController

Configuration block for deployment controller configuration. See below.

deploymentMaximumPercent number

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

deploymentMinimumHealthyPercent number

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

desiredCount number

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

enableEcsManagedTags boolean

Whether to enable Amazon ECS managed tags for the tasks within the service.

enableExecuteCommand boolean

Whether to enable Amazon ECS Exec for the tasks within the service.

forceDelete boolean

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

forceNewDeployment boolean

healthCheckGracePeriodSeconds number

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

iamRole string

launchType string

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

loadBalancers ServiceLoadBalancer[]

Configuration block for load balancers. See below.

name string

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

networkConfiguration ServiceNetworkConfiguration

orderedPlacementStrategies ServiceOrderedPlacementStrategy[]

placementConstraints ServicePlacementConstraint[]

platformVersion string

propagateTags string

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

schedulingStrategy string

serviceConnectConfiguration ServiceServiceConnectConfiguration

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

serviceRegistries ServiceServiceRegistries

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

tags {[key: string]: string}

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

taskDefinition string

triggers {[key: string]: string}

volumeConfiguration ServiceVolumeConfiguration

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

vpcLatticeConfigurations ServiceVpcLatticeConfiguration[]

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

waitForSteadyState boolean

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

alarms ServiceAlarmsArgs

Information about the CloudWatch alarms. See below.

availability_zone_rebalancing str

capacity_provider_strategies Sequence[ServiceCapacityProviderStrategyArgs]

cluster str

ARN of an ECS cluster.

deployment_circuit_breaker ServiceDeploymentCircuitBreakerArgs

Configuration block for deployment circuit breaker. See below.

deployment_controller ServiceDeploymentControllerArgs

Configuration block for deployment controller configuration. See below.

deployment_maximum_percent int

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

deployment_minimum_healthy_percent int

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

desired_count int

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

enable_ecs_managed_tags bool

Whether to enable Amazon ECS managed tags for the tasks within the service.

enable_execute_command bool

Whether to enable Amazon ECS Exec for the tasks within the service.

force_delete bool

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

force_new_deployment bool

health_check_grace_period_seconds int

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

iam_role str

launch_type str

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

load_balancers Sequence[ServiceLoadBalancerArgs]

Configuration block for load balancers. See below.

name str

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

network_configuration ServiceNetworkConfigurationArgs

ordered_placement_strategies Sequence[ServiceOrderedPlacementStrategyArgs]

placement_constraints Sequence[ServicePlacementConstraintArgs]

platform_version str

propagate_tags str

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

scheduling_strategy str

service_connect_configuration ServiceServiceConnectConfigurationArgs

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

service_registries ServiceServiceRegistriesArgs

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

tags Mapping[str, str]

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

task_definition str

triggers Mapping[str, str]

volume_configuration ServiceVolumeConfigurationArgs

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

vpc_lattice_configurations Sequence[ServiceVpcLatticeConfigurationArgs]

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

wait_for_steady_state bool

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

alarms Property Map

Information about the CloudWatch alarms. See below.

availabilityZoneRebalancing String

capacityProviderStrategies List<Property Map>

cluster String

ARN of an ECS cluster.

deploymentCircuitBreaker Property Map

Configuration block for deployment circuit breaker. See below.

deploymentController Property Map

Configuration block for deployment controller configuration. See below.

deploymentMaximumPercent Number

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

deploymentMinimumHealthyPercent Number

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

desiredCount Number

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

enableEcsManagedTags Boolean

Whether to enable Amazon ECS managed tags for the tasks within the service.

enableExecuteCommand Boolean

Whether to enable Amazon ECS Exec for the tasks within the service.

forceDelete Boolean

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

forceNewDeployment Boolean

healthCheckGracePeriodSeconds Number

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

iamRole String

launchType String

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

loadBalancers List<Property Map>

Configuration block for load balancers. See below.

name String

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

networkConfiguration Property Map

orderedPlacementStrategies List<Property Map>

placementConstraints List<Property Map>

platformVersion String

propagateTags String

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

schedulingStrategy String

serviceConnectConfiguration Property Map

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

serviceRegistries Property Map

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

tags Map<String>

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

taskDefinition String

triggers Map<String>

volumeConfiguration Property Map

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

vpcLatticeConfigurations List<Property Map>

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

waitForSteadyState Boolean

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

Outputs

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

Id string: The provider-assigned unique ID for this managed resource.
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.

Id string: The provider-assigned unique ID for this managed resource.
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.

id String: The provider-assigned unique ID for this managed resource.
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.

id string: The provider-assigned unique ID for this managed resource.
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.

id str: The provider-assigned unique ID for this managed resource.
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.

id String: The provider-assigned unique ID for this managed resource.
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.

Look up Existing Service Resource

Get an existing Service 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?: ServiceState, opts?: CustomResourceOptions): Service

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        alarms: Optional[ServiceAlarmsArgs] = None,
        availability_zone_rebalancing: Optional[str] = None,
        capacity_provider_strategies: Optional[Sequence[ServiceCapacityProviderStrategyArgs]] = None,
        cluster: Optional[str] = None,
        deployment_circuit_breaker: Optional[ServiceDeploymentCircuitBreakerArgs] = None,
        deployment_controller: Optional[ServiceDeploymentControllerArgs] = None,
        deployment_maximum_percent: Optional[int] = None,
        deployment_minimum_healthy_percent: Optional[int] = None,
        desired_count: Optional[int] = None,
        enable_ecs_managed_tags: Optional[bool] = None,
        enable_execute_command: Optional[bool] = None,
        force_delete: Optional[bool] = None,
        force_new_deployment: Optional[bool] = None,
        health_check_grace_period_seconds: Optional[int] = None,
        iam_role: Optional[str] = None,
        launch_type: Optional[str] = None,
        load_balancers: Optional[Sequence[ServiceLoadBalancerArgs]] = None,
        name: Optional[str] = None,
        network_configuration: Optional[ServiceNetworkConfigurationArgs] = None,
        ordered_placement_strategies: Optional[Sequence[ServiceOrderedPlacementStrategyArgs]] = None,
        placement_constraints: Optional[Sequence[ServicePlacementConstraintArgs]] = None,
        platform_version: Optional[str] = None,
        propagate_tags: Optional[str] = None,
        scheduling_strategy: Optional[str] = None,
        service_connect_configuration: Optional[ServiceServiceConnectConfigurationArgs] = None,
        service_registries: Optional[ServiceServiceRegistriesArgs] = None,
        tags: Optional[Mapping[str, str]] = None,
        tags_all: Optional[Mapping[str, str]] = None,
        task_definition: Optional[str] = None,
        triggers: Optional[Mapping[str, str]] = None,
        volume_configuration: Optional[ServiceVolumeConfigurationArgs] = None,
        vpc_lattice_configurations: Optional[Sequence[ServiceVpcLatticeConfigurationArgs]] = None,
        wait_for_steady_state: Optional[bool] = None) -> Service

func GetService(ctx *Context, name string, id IDInput, state *ServiceState, opts ...ResourceOption) (*Service, error)

public static Service Get(string name, Input<string> id, ServiceState? state, CustomResourceOptions? opts = null)

public static Service get(String name, Output<String> id, ServiceState state, CustomResourceOptions options)

resources:  _:    type: aws:ecs:Service    get:      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:

Alarms ServiceAlarms

Information about the CloudWatch alarms. See below.

AvailabilityZoneRebalancing string

CapacityProviderStrategies List<ServiceCapacityProviderStrategy>

Cluster string

ARN of an ECS cluster.

DeploymentCircuitBreaker ServiceDeploymentCircuitBreaker

Configuration block for deployment circuit breaker. See below.

DeploymentController ServiceDeploymentController

Configuration block for deployment controller configuration. See below.

DeploymentMaximumPercent int

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

DeploymentMinimumHealthyPercent int

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

DesiredCount int

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

EnableEcsManagedTags bool

Whether to enable Amazon ECS managed tags for the tasks within the service.

EnableExecuteCommand bool

Whether to enable Amazon ECS Exec for the tasks within the service.

ForceDelete bool

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

ForceNewDeployment bool

HealthCheckGracePeriodSeconds int

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

IamRole string

LaunchType string

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

LoadBalancers List<ServiceLoadBalancer>

Configuration block for load balancers. See below.

Name string

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

NetworkConfiguration ServiceNetworkConfiguration

OrderedPlacementStrategies List<ServiceOrderedPlacementStrategy>

PlacementConstraints List<ServicePlacementConstraint>

PlatformVersion string

PropagateTags string

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

SchedulingStrategy string

ServiceConnectConfiguration ServiceServiceConnectConfiguration

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

ServiceRegistries ServiceServiceRegistries

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

Tags Dictionary<string, string>

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

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

Triggers Dictionary<string, string>

VolumeConfiguration ServiceVolumeConfiguration

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

VpcLatticeConfigurations List<ServiceVpcLatticeConfiguration>

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

WaitForSteadyState bool

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

Alarms ServiceAlarmsArgs

Information about the CloudWatch alarms. See below.

AvailabilityZoneRebalancing string

CapacityProviderStrategies []ServiceCapacityProviderStrategyArgs

Cluster string

ARN of an ECS cluster.

DeploymentCircuitBreaker ServiceDeploymentCircuitBreakerArgs

Configuration block for deployment circuit breaker. See below.

DeploymentController ServiceDeploymentControllerArgs

Configuration block for deployment controller configuration. See below.

DeploymentMaximumPercent int

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

DeploymentMinimumHealthyPercent int

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

DesiredCount int

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

EnableEcsManagedTags bool

Whether to enable Amazon ECS managed tags for the tasks within the service.

EnableExecuteCommand bool

Whether to enable Amazon ECS Exec for the tasks within the service.

ForceDelete bool

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

ForceNewDeployment bool

HealthCheckGracePeriodSeconds int

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

IamRole string

LaunchType string

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

LoadBalancers []ServiceLoadBalancerArgs

Configuration block for load balancers. See below.

Name string

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

NetworkConfiguration ServiceNetworkConfigurationArgs

OrderedPlacementStrategies []ServiceOrderedPlacementStrategyArgs

PlacementConstraints []ServicePlacementConstraintArgs

PlatformVersion string

PropagateTags string

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

SchedulingStrategy string

ServiceConnectConfiguration ServiceServiceConnectConfigurationArgs

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

ServiceRegistries ServiceServiceRegistriesArgs

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

Tags map[string]string

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

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

Triggers map[string]string

VolumeConfiguration ServiceVolumeConfigurationArgs

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

VpcLatticeConfigurations []ServiceVpcLatticeConfigurationArgs

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

WaitForSteadyState bool

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

alarms ServiceAlarms

Information about the CloudWatch alarms. See below.

availabilityZoneRebalancing String

capacityProviderStrategies List<ServiceCapacityProviderStrategy>

cluster String

ARN of an ECS cluster.

deploymentCircuitBreaker ServiceDeploymentCircuitBreaker

Configuration block for deployment circuit breaker. See below.

deploymentController ServiceDeploymentController

Configuration block for deployment controller configuration. See below.

deploymentMaximumPercent Integer

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

deploymentMinimumHealthyPercent Integer

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

desiredCount Integer

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

enableEcsManagedTags Boolean

Whether to enable Amazon ECS managed tags for the tasks within the service.

enableExecuteCommand Boolean

Whether to enable Amazon ECS Exec for the tasks within the service.

forceDelete Boolean

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

forceNewDeployment Boolean

healthCheckGracePeriodSeconds Integer

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

iamRole String

launchType String

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

loadBalancers List<ServiceLoadBalancer>

Configuration block for load balancers. See below.

name String

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

networkConfiguration ServiceNetworkConfiguration

orderedPlacementStrategies List<ServiceOrderedPlacementStrategy>

placementConstraints List<ServicePlacementConstraint>

platformVersion String

propagateTags String

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

schedulingStrategy String

serviceConnectConfiguration ServiceServiceConnectConfiguration

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

serviceRegistries ServiceServiceRegistries

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

tags Map<String,String>

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

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

triggers Map<String,String>

volumeConfiguration ServiceVolumeConfiguration

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

vpcLatticeConfigurations List<ServiceVpcLatticeConfiguration>

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

waitForSteadyState Boolean

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

alarms ServiceAlarms

Information about the CloudWatch alarms. See below.

availabilityZoneRebalancing string

capacityProviderStrategies ServiceCapacityProviderStrategy[]

cluster string

ARN of an ECS cluster.

deploymentCircuitBreaker ServiceDeploymentCircuitBreaker

Configuration block for deployment circuit breaker. See below.

deploymentController ServiceDeploymentController

Configuration block for deployment controller configuration. See below.

deploymentMaximumPercent number

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

deploymentMinimumHealthyPercent number

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

desiredCount number

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

enableEcsManagedTags boolean

Whether to enable Amazon ECS managed tags for the tasks within the service.

enableExecuteCommand boolean

Whether to enable Amazon ECS Exec for the tasks within the service.

forceDelete boolean

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

forceNewDeployment boolean

healthCheckGracePeriodSeconds number

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

iamRole string

launchType string

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

loadBalancers ServiceLoadBalancer[]

Configuration block for load balancers. See below.

name string

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

networkConfiguration ServiceNetworkConfiguration

orderedPlacementStrategies ServiceOrderedPlacementStrategy[]

placementConstraints ServicePlacementConstraint[]

platformVersion string

propagateTags string

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

schedulingStrategy string

serviceConnectConfiguration ServiceServiceConnectConfiguration

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

serviceRegistries ServiceServiceRegistries

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

tags {[key: string]: string}

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

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

triggers {[key: string]: string}

volumeConfiguration ServiceVolumeConfiguration

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

vpcLatticeConfigurations ServiceVpcLatticeConfiguration[]

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

waitForSteadyState boolean

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

alarms ServiceAlarmsArgs

Information about the CloudWatch alarms. See below.

availability_zone_rebalancing str

capacity_provider_strategies Sequence[ServiceCapacityProviderStrategyArgs]

cluster str

ARN of an ECS cluster.

deployment_circuit_breaker ServiceDeploymentCircuitBreakerArgs

Configuration block for deployment circuit breaker. See below.

deployment_controller ServiceDeploymentControllerArgs

Configuration block for deployment controller configuration. See below.

deployment_maximum_percent int

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

deployment_minimum_healthy_percent int

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

desired_count int

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

enable_ecs_managed_tags bool

Whether to enable Amazon ECS managed tags for the tasks within the service.

enable_execute_command bool

Whether to enable Amazon ECS Exec for the tasks within the service.

force_delete bool

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

force_new_deployment bool

health_check_grace_period_seconds int

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

iam_role str

launch_type str

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

load_balancers Sequence[ServiceLoadBalancerArgs]

Configuration block for load balancers. See below.

name str

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

network_configuration ServiceNetworkConfigurationArgs

ordered_placement_strategies Sequence[ServiceOrderedPlacementStrategyArgs]

placement_constraints Sequence[ServicePlacementConstraintArgs]

platform_version str

propagate_tags str

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

scheduling_strategy str

service_connect_configuration ServiceServiceConnectConfigurationArgs

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

service_registries ServiceServiceRegistriesArgs

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

tags Mapping[str, str]

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

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

triggers Mapping[str, str]

volume_configuration ServiceVolumeConfigurationArgs

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

vpc_lattice_configurations Sequence[ServiceVpcLatticeConfigurationArgs]

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

wait_for_steady_state bool

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

alarms Property Map

Information about the CloudWatch alarms. See below.

availabilityZoneRebalancing String

capacityProviderStrategies List<Property Map>

cluster String

ARN of an ECS cluster.

deploymentCircuitBreaker Property Map

Configuration block for deployment circuit breaker. See below.

deploymentController Property Map

Configuration block for deployment controller configuration. See below.

deploymentMaximumPercent Number

Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the DAEMON scheduling strategy.

deploymentMinimumHealthyPercent Number

Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.

desiredCount Number

Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the DAEMON scheduling strategy.

enableEcsManagedTags Boolean

Whether to enable Amazon ECS managed tags for the tasks within the service.

enableExecuteCommand Boolean

Whether to enable Amazon ECS Exec for the tasks within the service.

forceDelete Boolean

Enable to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

forceNewDeployment Boolean

healthCheckGracePeriodSeconds Number

Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.

iamRole String

launchType String

Launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2. Conflicts with capacity_provider_strategy.

loadBalancers List<Property Map>

Configuration block for load balancers. See below.

name String

Name of the service (up to 255 letters, numbers, hyphens, and underscores)

The following arguments are optional:

networkConfiguration Property Map

orderedPlacementStrategies List<Property Map>

placementConstraints List<Property Map>

platformVersion String

propagateTags String

Whether to propagate the tags from the task definition or the service to the tasks. The valid values are SERVICE and TASK_DEFINITION.

schedulingStrategy String

serviceConnectConfiguration Property Map

ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.

serviceRegistries Property Map

Service discovery registries for the service. The maximum number of service_registries blocks is 1. See below.

tags Map<String>

Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

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

triggers Map<String>

volumeConfiguration Property Map

Configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. See below.

vpcLatticeConfigurations List<Property Map>

The VPC Lattice configuration for your service that allows Lattice to connect, secure, and monitor your service across multiple accounts and VPCs. See below.

waitForSteadyState Boolean

If true, this provider will wait for the service to reach a steady state (like aws ecs wait services-stable) before continuing. Default false.

Supporting Types

ServiceAlarms, ServiceAlarmsArgs

AlarmNames List<string>: One or more CloudWatch alarm names.
Enable bool: Whether to use the CloudWatch alarm option in the service deployment process.
Rollback bool: Whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

AlarmNames []string: One or more CloudWatch alarm names.
Enable bool: Whether to use the CloudWatch alarm option in the service deployment process.
Rollback bool: Whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

alarmNames List<String>: One or more CloudWatch alarm names.
enable Boolean: Whether to use the CloudWatch alarm option in the service deployment process.
rollback Boolean: Whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

alarmNames string[]: One or more CloudWatch alarm names.
enable boolean: Whether to use the CloudWatch alarm option in the service deployment process.
rollback boolean: Whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

alarm_names Sequence[str]: One or more CloudWatch alarm names.
enable bool: Whether to use the CloudWatch alarm option in the service deployment process.
rollback bool: Whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

alarmNames List<String>: One or more CloudWatch alarm names.
enable Boolean: Whether to use the CloudWatch alarm option in the service deployment process.
rollback Boolean: Whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

ServiceCapacityProviderStrategy, ServiceCapacityProviderStrategyArgs

CapacityProvider string: Short name of the 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.
Weight int: Relative percentage of the total number of launched tasks that should use the specified capacity provider.

CapacityProvider string: Short name of the 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.
Weight int: Relative percentage of the total number of launched tasks that should use the specified capacity provider.

capacityProvider String: Short name of the 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.
weight Integer: Relative percentage of the total number of launched tasks that should use the specified capacity provider.

capacityProvider string: Short name of the 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.
weight number: Relative percentage of the total number of launched tasks that should use the specified capacity provider.

capacity_provider str: Short name of the 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.
weight int: Relative percentage of the total number of launched tasks that should use the specified capacity provider.

capacityProvider String: Short name of the 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.
weight Number: Relative percentage of the total number of launched tasks that should use the specified capacity provider.

ServiceDeploymentCircuitBreaker, ServiceDeploymentCircuitBreakerArgs

Enable bool: Whether to enable the deployment circuit breaker logic for the service.
Rollback bool: Whether to enable Amazon ECS to roll back the service if a service deployment fails. If rollback is enabled, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

Enable bool: Whether to enable the deployment circuit breaker logic for the service.
Rollback bool: Whether to enable Amazon ECS to roll back the service if a service deployment fails. If rollback is enabled, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

enable Boolean: Whether to enable the deployment circuit breaker logic for the service.
rollback Boolean: Whether to enable Amazon ECS to roll back the service if a service deployment fails. If rollback is enabled, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

enable boolean: Whether to enable the deployment circuit breaker logic for the service.
rollback boolean: Whether to enable Amazon ECS to roll back the service if a service deployment fails. If rollback is enabled, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

enable bool: Whether to enable the deployment circuit breaker logic for the service.
rollback bool: Whether to enable Amazon ECS to roll back the service if a service deployment fails. If rollback is enabled, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

enable Boolean: Whether to enable the deployment circuit breaker logic for the service.
rollback Boolean: Whether to enable Amazon ECS to roll back the service if a service deployment fails. If rollback is enabled, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

ServiceDeploymentController, ServiceDeploymentControllerArgs

Type string: Type of deployment controller. Valid values: CODE_DEPLOY, ECS, EXTERNAL. Default: ECS.

Type string: Type of deployment controller. Valid values: CODE_DEPLOY, ECS, EXTERNAL. Default: ECS.

type String: Type of deployment controller. Valid values: CODE_DEPLOY, ECS, EXTERNAL. Default: ECS.

type string: Type of deployment controller. Valid values: CODE_DEPLOY, ECS, EXTERNAL. Default: ECS.

type str: Type of deployment controller. Valid values: CODE_DEPLOY, ECS, EXTERNAL. Default: ECS.

type String: Type of deployment controller. Valid values: CODE_DEPLOY, ECS, EXTERNAL. Default: ECS.

ServiceLoadBalancer, ServiceLoadBalancerArgs

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.
Version note: Multiple load_balancer configuration block support was added in version 2.22.0 of the provider. This allows configuration of ECS service support for multiple target groups.
ElbName 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.

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.
Version note: Multiple load_balancer configuration block support was added in version 2.22.0 of the provider. This allows configuration of ECS service support for multiple target groups.
ElbName 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.

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.
Version note: Multiple load_balancer configuration block support was added in version 2.22.0 of the provider. This allows configuration of ECS service support for multiple target groups.
elbName 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.

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.
Version note: Multiple load_balancer configuration block support was added in version 2.22.0 of the provider. This allows configuration of ECS service support for multiple target groups.
elbName 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.

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.
Version note: Multiple load_balancer configuration block support was added in version 2.22.0 of the provider. This allows configuration of ECS service support for multiple target groups.
elb_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.

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.
Version note: Multiple load_balancer configuration block support was added in version 2.22.0 of the provider. This allows configuration of ECS service support for multiple target groups.
elbName 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.

ServiceNetworkConfiguration, ServiceNetworkConfigurationArgs

Subnets List<string>

Subnets associated with the task or service.

AssignPublicIp bool

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>

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.

Subnets []string

Subnets associated with the task or service.

AssignPublicIp bool

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

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.

subnets List<String>

Subnets associated with the task or service.

assignPublicIp Boolean

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>

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.

subnets string[]

Subnets associated with the task or service.

assignPublicIp boolean

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[]

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.

subnets Sequence[str]

Subnets associated with the task or service.

assign_public_ip bool

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]

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.

subnets List<String>

Subnets associated with the task or service.

assignPublicIp Boolean

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>

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.

ServiceOrderedPlacementStrategy, ServiceOrderedPlacementStrategyArgs

Type string: Type of placement strategy. Must be one of: binpack, random, or spread
Field string: For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance. For the binpack type, valid values are memory and cpu. For the random type, this attribute is not needed. For more information, see Placement Strategy.
Note: for spread, host and instanceId will be normalized, by AWS, to be instanceId. This means the statefile will show instanceId but your config will differ if you use host.

Type string: Type of placement strategy. Must be one of: binpack, random, or spread
Field string: For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance. For the binpack type, valid values are memory and cpu. For the random type, this attribute is not needed. For more information, see Placement Strategy.
Note: for spread, host and instanceId will be normalized, by AWS, to be instanceId. This means the statefile will show instanceId but your config will differ if you use host.

type String: Type of placement strategy. Must be one of: binpack, random, or spread
field String: For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance. For the binpack type, valid values are memory and cpu. For the random type, this attribute is not needed. For more information, see Placement Strategy.
Note: for spread, host and instanceId will be normalized, by AWS, to be instanceId. This means the statefile will show instanceId but your config will differ if you use host.

type string: Type of placement strategy. Must be one of: binpack, random, or spread
field string: For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance. For the binpack type, valid values are memory and cpu. For the random type, this attribute is not needed. For more information, see Placement Strategy.
Note: for spread, host and instanceId will be normalized, by AWS, to be instanceId. This means the statefile will show instanceId but your config will differ if you use host.

type str: Type of placement strategy. Must be one of: binpack, random, or spread
field str: For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance. For the binpack type, valid values are memory and cpu. For the random type, this attribute is not needed. For more information, see Placement Strategy.
Note: for spread, host and instanceId will be normalized, by AWS, to be instanceId. This means the statefile will show instanceId but your config will differ if you use host.

type String: Type of placement strategy. Must be one of: binpack, random, or spread
field String: For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that is applied to a container instance. For the binpack type, valid values are memory and cpu. For the random type, this attribute is not needed. For more information, see Placement Strategy.
Note: for spread, host and instanceId will be normalized, by AWS, to be instanceId. This means the statefile will show instanceId but your config will differ if you use host.

ServicePlacementConstraint, ServicePlacementConstraintArgs

Type string: Type of constraint. The only valid values at this time are memberOf and distinctInstance.
Expression string: Cluster Query Language expression to apply to the constraint. Does not need to be specified for the distinctInstance type. For more information, see Cluster Query Language in the Amazon EC2 Container Service Developer Guide.

Type string: Type of constraint. The only valid values at this time are memberOf and distinctInstance.
Expression string: Cluster Query Language expression to apply to the constraint. Does not need to be specified for the distinctInstance type. For more information, see Cluster Query Language in the Amazon EC2 Container Service Developer Guide.

type String: Type of constraint. The only valid values at this time are memberOf and distinctInstance.
expression String: Cluster Query Language expression to apply to the constraint. Does not need to be specified for the distinctInstance type. For more information, see Cluster Query Language in the Amazon EC2 Container Service Developer Guide.

type string: Type of constraint. The only valid values at this time are memberOf and distinctInstance.
expression string: Cluster Query Language expression to apply to the constraint. Does not need to be specified for the distinctInstance type. For more information, see Cluster Query Language in the Amazon EC2 Container Service Developer Guide.

type str: Type of constraint. The only valid values at this time are memberOf and distinctInstance.
expression str: Cluster Query Language expression to apply to the constraint. Does not need to be specified for the distinctInstance type. For more information, see Cluster Query Language in the Amazon EC2 Container Service Developer Guide.

type String: Type of constraint. The only valid values at this time are memberOf and distinctInstance.
expression String: Cluster Query Language expression to apply to the constraint. Does not need to be specified for the distinctInstance type. For more information, see Cluster Query Language in the Amazon EC2 Container Service Developer Guide.

ServiceServiceConnectConfiguration, ServiceServiceConnectConfigurationArgs

Enabled bool: Whether to use Service Connect with this service.
LogConfiguration ServiceServiceConnectConfigurationLogConfiguration: Log configuration for the container. See below.
Namespace string: Namespace name or ARN of the aws.servicediscovery.HttpNamespace for use with Service Connect.
Services List<ServiceServiceConnectConfigurationService>: List of Service Connect service objects. See below.

Enabled bool: Whether to use Service Connect with this service.
LogConfiguration ServiceServiceConnectConfigurationLogConfiguration: Log configuration for the container. See below.
Namespace string: Namespace name or ARN of the aws.servicediscovery.HttpNamespace for use with Service Connect.
Services []ServiceServiceConnectConfigurationService: List of Service Connect service objects. See below.

enabled Boolean: Whether to use Service Connect with this service.
logConfiguration ServiceServiceConnectConfigurationLogConfiguration: Log configuration for the container. See below.
namespace String: Namespace name or ARN of the aws.servicediscovery.HttpNamespace for use with Service Connect.
services List<ServiceServiceConnectConfigurationService>: List of Service Connect service objects. See below.

enabled boolean: Whether to use Service Connect with this service.
logConfiguration ServiceServiceConnectConfigurationLogConfiguration: Log configuration for the container. See below.
namespace string: Namespace name or ARN of the aws.servicediscovery.HttpNamespace for use with Service Connect.
services ServiceServiceConnectConfigurationService[]: List of Service Connect service objects. See below.

enabled bool: Whether to use Service Connect with this service.
log_configuration ServiceServiceConnectConfigurationLogConfiguration: Log configuration for the container. See below.
namespace str: Namespace name or ARN of the aws.servicediscovery.HttpNamespace for use with Service Connect.
services Sequence[ServiceServiceConnectConfigurationService]: List of Service Connect service objects. See below.

enabled Boolean: Whether to use Service Connect with this service.
logConfiguration Property Map: Log configuration for the container. See below.
namespace String: Namespace name or ARN of the aws.servicediscovery.HttpNamespace for use with Service Connect.
services List<Property Map>: List of Service Connect service objects. See below.

ServiceServiceConnectConfigurationLogConfiguration, ServiceServiceConnectConfigurationLogConfigurationArgs

LogDriver string: Log driver to use for the container.
Options Dictionary<string, string>: Configuration options to send to the log driver.
SecretOptions List<ServiceServiceConnectConfigurationLogConfigurationSecretOption>: Secrets to pass to the log configuration. See below.

LogDriver string: Log driver to use for the container.
Options map[string]string: Configuration options to send to the log driver.
SecretOptions []ServiceServiceConnectConfigurationLogConfigurationSecretOption: Secrets to pass to the log configuration. See below.

logDriver String: Log driver to use for the container.
options Map<String,String>: Configuration options to send to the log driver.
secretOptions List<ServiceServiceConnectConfigurationLogConfigurationSecretOption>: Secrets to pass to the log configuration. See below.

logDriver string: Log driver to use for the container.
options {[key: string]: string}: Configuration options to send to the log driver.
secretOptions ServiceServiceConnectConfigurationLogConfigurationSecretOption[]: Secrets to pass to the log configuration. See below.

log_driver str: Log driver to use for the container.
options Mapping[str, str]: Configuration options to send to the log driver.
secret_options Sequence[ServiceServiceConnectConfigurationLogConfigurationSecretOption]: Secrets to pass to the log configuration. See below.

logDriver String: Log driver to use for the container.
options Map<String>: Configuration options to send to the log driver.
secretOptions List<Property Map>: Secrets to pass to the log configuration. See below.

ServiceServiceConnectConfigurationLogConfigurationSecretOption, ServiceServiceConnectConfigurationLogConfigurationSecretOptionArgs

Name string: Name of the secret.
ValueFrom string: Secret to expose to the container. The supported values are either the full ARN of the AWS Secrets Manager secret or the full ARN of the parameter in the SSM Parameter Store.

Name string: Name of the secret.
ValueFrom string: Secret to expose to the container. The supported values are either the full ARN of the AWS Secrets Manager secret or the full ARN of the parameter in the SSM Parameter Store.

name String: Name of the secret.
valueFrom String: Secret to expose to the container. The supported values are either the full ARN of the AWS Secrets Manager secret or the full ARN of the parameter in the SSM Parameter Store.

name string: Name of the secret.
valueFrom string: Secret to expose to the container. The supported values are either the full ARN of the AWS Secrets Manager secret or the full ARN of the parameter in the SSM Parameter Store.

name str: Name of the secret.
value_from str: Secret to expose to the container. The supported values are either the full ARN of the AWS Secrets Manager secret or the full ARN of the parameter in the SSM Parameter Store.

name String: Name of the secret.
valueFrom String: Secret to expose to the container. The supported values are either the full ARN of the AWS Secrets Manager secret or the full ARN of the parameter in the SSM Parameter Store.

ServiceServiceConnectConfigurationService, ServiceServiceConnectConfigurationServiceArgs

PortName string: Name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.
ClientAlias List<ServiceServiceConnectConfigurationServiceClientAlias>: List of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1. See below.
DiscoveryName string: Name of the new AWS Cloud Map service that Amazon ECS creates for this Amazon ECS service.
IngressPortOverride int: Port number for the Service Connect proxy to listen on.
Timeout ServiceServiceConnectConfigurationServiceTimeout: Configuration timeouts for Service Connect
Tls ServiceServiceConnectConfigurationServiceTls: Configuration for enabling Transport Layer Security (TLS)

PortName string: Name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.
ClientAlias []ServiceServiceConnectConfigurationServiceClientAlias: List of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1. See below.
DiscoveryName string: Name of the new AWS Cloud Map service that Amazon ECS creates for this Amazon ECS service.
IngressPortOverride int: Port number for the Service Connect proxy to listen on.
Timeout ServiceServiceConnectConfigurationServiceTimeout: Configuration timeouts for Service Connect
Tls ServiceServiceConnectConfigurationServiceTls: Configuration for enabling Transport Layer Security (TLS)

portName String: Name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.
clientAlias List<ServiceServiceConnectConfigurationServiceClientAlias>: List of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1. See below.
discoveryName String: Name of the new AWS Cloud Map service that Amazon ECS creates for this Amazon ECS service.
ingressPortOverride Integer: Port number for the Service Connect proxy to listen on.
timeout ServiceServiceConnectConfigurationServiceTimeout: Configuration timeouts for Service Connect
tls ServiceServiceConnectConfigurationServiceTls: Configuration for enabling Transport Layer Security (TLS)

portName string: Name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.
clientAlias ServiceServiceConnectConfigurationServiceClientAlias[]: List of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1. See below.
discoveryName string: Name of the new AWS Cloud Map service that Amazon ECS creates for this Amazon ECS service.
ingressPortOverride number: Port number for the Service Connect proxy to listen on.
timeout ServiceServiceConnectConfigurationServiceTimeout: Configuration timeouts for Service Connect
tls ServiceServiceConnectConfigurationServiceTls: Configuration for enabling Transport Layer Security (TLS)

port_name str: Name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.
client_alias Sequence[ServiceServiceConnectConfigurationServiceClientAlias]: List of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1. See below.
discovery_name str: Name of the new AWS Cloud Map service that Amazon ECS creates for this Amazon ECS service.
ingress_port_override int: Port number for the Service Connect proxy to listen on.
timeout ServiceServiceConnectConfigurationServiceTimeout: Configuration timeouts for Service Connect
tls ServiceServiceConnectConfigurationServiceTls: Configuration for enabling Transport Layer Security (TLS)

portName String: Name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.
clientAlias List<Property Map>: List of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1. See below.
discoveryName String: Name of the new AWS Cloud Map service that Amazon ECS creates for this Amazon ECS service.
ingressPortOverride Number: Port number for the Service Connect proxy to listen on.
timeout Property Map: Configuration timeouts for Service Connect
tls Property Map: Configuration for enabling Transport Layer Security (TLS)

ServiceServiceConnectConfigurationServiceClientAlias, ServiceServiceConnectConfigurationServiceClientAliasArgs

Port int: Listening port number for the Service Connect proxy. This port is available inside of all of the tasks within the same namespace.
DnsName string: Name that you use in the applications of client tasks to connect to this service.

Port int: Listening port number for the Service Connect proxy. This port is available inside of all of the tasks within the same namespace.
DnsName string: Name that you use in the applications of client tasks to connect to this service.

port Integer: Listening port number for the Service Connect proxy. This port is available inside of all of the tasks within the same namespace.
dnsName String: Name that you use in the applications of client tasks to connect to this service.

port number: Listening port number for the Service Connect proxy. This port is available inside of all of the tasks within the same namespace.
dnsName string: Name that you use in the applications of client tasks to connect to this service.

port int: Listening port number for the Service Connect proxy. This port is available inside of all of the tasks within the same namespace.
dns_name str: Name that you use in the applications of client tasks to connect to this service.

port Number: Listening port number for the Service Connect proxy. This port is available inside of all of the tasks within the same namespace.
dnsName String: Name that you use in the applications of client tasks to connect to this service.

ServiceServiceConnectConfigurationServiceTimeout, ServiceServiceConnectConfigurationServiceTimeoutArgs

IdleTimeoutSeconds int: Amount of time in seconds a connection will stay active while idle. A value of 0 can be set to disable idleTimeout.
PerRequestTimeoutSeconds int: Amount of time in seconds for the upstream to respond with a complete response per request. A value of 0 can be set to disable perRequestTimeout. Can only be set when appProtocol isn't TCP.

IdleTimeoutSeconds int: Amount of time in seconds a connection will stay active while idle. A value of 0 can be set to disable idleTimeout.
PerRequestTimeoutSeconds int: Amount of time in seconds for the upstream to respond with a complete response per request. A value of 0 can be set to disable perRequestTimeout. Can only be set when appProtocol isn't TCP.

idleTimeoutSeconds Integer: Amount of time in seconds a connection will stay active while idle. A value of 0 can be set to disable idleTimeout.
perRequestTimeoutSeconds Integer: Amount of time in seconds for the upstream to respond with a complete response per request. A value of 0 can be set to disable perRequestTimeout. Can only be set when appProtocol isn't TCP.

idleTimeoutSeconds number: Amount of time in seconds a connection will stay active while idle. A value of 0 can be set to disable idleTimeout.
perRequestTimeoutSeconds number: Amount of time in seconds for the upstream to respond with a complete response per request. A value of 0 can be set to disable perRequestTimeout. Can only be set when appProtocol isn't TCP.

idle_timeout_seconds int: Amount of time in seconds a connection will stay active while idle. A value of 0 can be set to disable idleTimeout.
per_request_timeout_seconds int: Amount of time in seconds for the upstream to respond with a complete response per request. A value of 0 can be set to disable perRequestTimeout. Can only be set when appProtocol isn't TCP.

idleTimeoutSeconds Number: Amount of time in seconds a connection will stay active while idle. A value of 0 can be set to disable idleTimeout.
perRequestTimeoutSeconds Number: Amount of time in seconds for the upstream to respond with a complete response per request. A value of 0 can be set to disable perRequestTimeout. Can only be set when appProtocol isn't TCP.

ServiceServiceConnectConfigurationServiceTls, ServiceServiceConnectConfigurationServiceTlsArgs

IssuerCertAuthority ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthority: Details of the certificate authority which will issue the certificate.
KmsKey string: KMS key used to encrypt the private key in Secrets Manager.
RoleArn string: ARN of the IAM Role that's associated with the Service Connect TLS.

IssuerCertAuthority ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthority: Details of the certificate authority which will issue the certificate.
KmsKey string: KMS key used to encrypt the private key in Secrets Manager.
RoleArn string: ARN of the IAM Role that's associated with the Service Connect TLS.

issuerCertAuthority ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthority: Details of the certificate authority which will issue the certificate.
kmsKey String: KMS key used to encrypt the private key in Secrets Manager.
roleArn String: ARN of the IAM Role that's associated with the Service Connect TLS.

issuerCertAuthority ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthority: Details of the certificate authority which will issue the certificate.
kmsKey string: KMS key used to encrypt the private key in Secrets Manager.
roleArn string: ARN of the IAM Role that's associated with the Service Connect TLS.

issuer_cert_authority ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthority: Details of the certificate authority which will issue the certificate.
kms_key str: KMS key used to encrypt the private key in Secrets Manager.
role_arn str: ARN of the IAM Role that's associated with the Service Connect TLS.

issuerCertAuthority Property Map: Details of the certificate authority which will issue the certificate.
kmsKey String: KMS key used to encrypt the private key in Secrets Manager.
roleArn String: ARN of the IAM Role that's associated with the Service Connect TLS.

ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthority, ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthorityArgs

AwsPcaAuthorityArn string: ARN of the aws.acmpca.CertificateAuthority used to create the TLS Certificates.

AwsPcaAuthorityArn string: ARN of the aws.acmpca.CertificateAuthority used to create the TLS Certificates.

awsPcaAuthorityArn String: ARN of the aws.acmpca.CertificateAuthority used to create the TLS Certificates.

awsPcaAuthorityArn string: ARN of the aws.acmpca.CertificateAuthority used to create the TLS Certificates.

aws_pca_authority_arn str: ARN of the aws.acmpca.CertificateAuthority used to create the TLS Certificates.

awsPcaAuthorityArn String: ARN of the aws.acmpca.CertificateAuthority used to create the TLS Certificates.

ServiceServiceRegistries, ServiceServiceRegistriesArgs

RegistryArn string: ARN of the Service Registry. The currently supported service registry is Amazon Route 53 Auto Naming Service(aws.servicediscovery.Service). 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). 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). 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). 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). 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). 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.

ServiceVolumeConfiguration, ServiceVolumeConfigurationArgs

ManagedEbsVolume ServiceVolumeConfigurationManagedEbsVolume: Configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf. See below.
Name string: Name of the volume.

ManagedEbsVolume ServiceVolumeConfigurationManagedEbsVolume: Configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf. See below.
Name string: Name of the volume.

managedEbsVolume ServiceVolumeConfigurationManagedEbsVolume: Configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf. See below.
name String: Name of the volume.

managedEbsVolume ServiceVolumeConfigurationManagedEbsVolume: Configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf. See below.
name string: Name of the volume.

managed_ebs_volume ServiceVolumeConfigurationManagedEbsVolume: Configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf. See below.
name str: Name of the volume.

managedEbsVolume Property Map: Configuration for the Amazon EBS volume that Amazon ECS creates and manages on your behalf. See below.
name String: Name of the volume.

ServiceVolumeConfigurationManagedEbsVolume, ServiceVolumeConfigurationManagedEbsVolumeArgs

RoleArn string: Amazon ECS infrastructure IAM role that is used to manage your Amazon Web Services infrastructure. Recommended using the Amazon ECS-managed AmazonECSInfrastructureRolePolicyForVolumes IAM policy with this role.
Encrypted bool: Whether the volume should be encrypted. Default value is true.
FileSystemType string: Linux filesystem type for the volume. For volumes created from a snapshot, same filesystem type must be specified that the volume was using when the snapshot was created. Valid values are ext3, ext4, xfs. Default value is xfs.
Iops int: Number of I/O operations per second (IOPS).
KmsKeyId string: Amazon Resource Name (ARN) identifier of the Amazon Web Services Key Management Service key to use for Amazon EBS encryption.
SizeInGb int: Size of the volume in GiB. You must specify either a size_in_gb or a snapshot_id. You can optionally specify a volume size greater than or equal to the snapshot size.
SnapshotId string: Snapshot that Amazon ECS uses to create the volume. You must specify either a size_in_gb or a snapshot_id.
TagSpecifications List<ServiceVolumeConfigurationManagedEbsVolumeTagSpecification>: The tags to apply to the volume. See below.
Throughput int: Throughput to provision for a volume, in MiB/s, with a maximum of 1,000 MiB/s.
VolumeType string: Volume type.

RoleArn string: Amazon ECS infrastructure IAM role that is used to manage your Amazon Web Services infrastructure. Recommended using the Amazon ECS-managed AmazonECSInfrastructureRolePolicyForVolumes IAM policy with this role.
Encrypted bool: Whether the volume should be encrypted. Default value is true.
FileSystemType string: Linux filesystem type for the volume. For volumes created from a snapshot, same filesystem type must be specified that the volume was using when the snapshot was created. Valid values are ext3, ext4, xfs. Default value is xfs.
Iops int: Number of I/O operations per second (IOPS).
KmsKeyId string: Amazon Resource Name (ARN) identifier of the Amazon Web Services Key Management Service key to use for Amazon EBS encryption.
SizeInGb int: Size of the volume in GiB. You must specify either a size_in_gb or a snapshot_id. You can optionally specify a volume size greater than or equal to the snapshot size.
SnapshotId string: Snapshot that Amazon ECS uses to create the volume. You must specify either a size_in_gb or a snapshot_id.
TagSpecifications []ServiceVolumeConfigurationManagedEbsVolumeTagSpecification: The tags to apply to the volume. See below.
Throughput int: Throughput to provision for a volume, in MiB/s, with a maximum of 1,000 MiB/s.
VolumeType string: Volume type.

roleArn String: Amazon ECS infrastructure IAM role that is used to manage your Amazon Web Services infrastructure. Recommended using the Amazon ECS-managed AmazonECSInfrastructureRolePolicyForVolumes IAM policy with this role.
encrypted Boolean: Whether the volume should be encrypted. Default value is true.
fileSystemType String: Linux filesystem type for the volume. For volumes created from a snapshot, same filesystem type must be specified that the volume was using when the snapshot was created. Valid values are ext3, ext4, xfs. Default value is xfs.
iops Integer: Number of I/O operations per second (IOPS).
kmsKeyId String: Amazon Resource Name (ARN) identifier of the Amazon Web Services Key Management Service key to use for Amazon EBS encryption.
sizeInGb Integer: Size of the volume in GiB. You must specify either a size_in_gb or a snapshot_id. You can optionally specify a volume size greater than or equal to the snapshot size.
snapshotId String: Snapshot that Amazon ECS uses to create the volume. You must specify either a size_in_gb or a snapshot_id.
tagSpecifications List<ServiceVolumeConfigurationManagedEbsVolumeTagSpecification>: The tags to apply to the volume. See below.
throughput Integer: Throughput to provision for a volume, in MiB/s, with a maximum of 1,000 MiB/s.
volumeType String: Volume type.

roleArn string: Amazon ECS infrastructure IAM role that is used to manage your Amazon Web Services infrastructure. Recommended using the Amazon ECS-managed AmazonECSInfrastructureRolePolicyForVolumes IAM policy with this role.
encrypted boolean: Whether the volume should be encrypted. Default value is true.
fileSystemType string: Linux filesystem type for the volume. For volumes created from a snapshot, same filesystem type must be specified that the volume was using when the snapshot was created. Valid values are ext3, ext4, xfs. Default value is xfs.
iops number: Number of I/O operations per second (IOPS).
kmsKeyId string: Amazon Resource Name (ARN) identifier of the Amazon Web Services Key Management Service key to use for Amazon EBS encryption.
sizeInGb number: Size of the volume in GiB. You must specify either a size_in_gb or a snapshot_id. You can optionally specify a volume size greater than or equal to the snapshot size.
snapshotId string: Snapshot that Amazon ECS uses to create the volume. You must specify either a size_in_gb or a snapshot_id.
tagSpecifications ServiceVolumeConfigurationManagedEbsVolumeTagSpecification[]: The tags to apply to the volume. See below.
throughput number: Throughput to provision for a volume, in MiB/s, with a maximum of 1,000 MiB/s.
volumeType string: Volume type.

role_arn str: Amazon ECS infrastructure IAM role that is used to manage your Amazon Web Services infrastructure. Recommended using the Amazon ECS-managed AmazonECSInfrastructureRolePolicyForVolumes IAM policy with this role.
encrypted bool: Whether the volume should be encrypted. Default value is true.
file_system_type str: Linux filesystem type for the volume. For volumes created from a snapshot, same filesystem type must be specified that the volume was using when the snapshot was created. Valid values are ext3, ext4, xfs. Default value is xfs.
iops int: Number of I/O operations per second (IOPS).
kms_key_id str: Amazon Resource Name (ARN) identifier of the Amazon Web Services Key Management Service key to use for Amazon EBS encryption.
size_in_gb int: Size of the volume in GiB. You must specify either a size_in_gb or a snapshot_id. You can optionally specify a volume size greater than or equal to the snapshot size.
snapshot_id str: Snapshot that Amazon ECS uses to create the volume. You must specify either a size_in_gb or a snapshot_id.
tag_specifications Sequence[ServiceVolumeConfigurationManagedEbsVolumeTagSpecification]: The tags to apply to the volume. See below.
throughput int: Throughput to provision for a volume, in MiB/s, with a maximum of 1,000 MiB/s.
volume_type str: Volume type.

roleArn String: Amazon ECS infrastructure IAM role that is used to manage your Amazon Web Services infrastructure. Recommended using the Amazon ECS-managed AmazonECSInfrastructureRolePolicyForVolumes IAM policy with this role.
encrypted Boolean: Whether the volume should be encrypted. Default value is true.
fileSystemType String: Linux filesystem type for the volume. For volumes created from a snapshot, same filesystem type must be specified that the volume was using when the snapshot was created. Valid values are ext3, ext4, xfs. Default value is xfs.
iops Number: Number of I/O operations per second (IOPS).
kmsKeyId String: Amazon Resource Name (ARN) identifier of the Amazon Web Services Key Management Service key to use for Amazon EBS encryption.
sizeInGb Number: Size of the volume in GiB. You must specify either a size_in_gb or a snapshot_id. You can optionally specify a volume size greater than or equal to the snapshot size.
snapshotId String: Snapshot that Amazon ECS uses to create the volume. You must specify either a size_in_gb or a snapshot_id.
tagSpecifications List<Property Map>: The tags to apply to the volume. See below.
throughput Number: Throughput to provision for a volume, in MiB/s, with a maximum of 1,000 MiB/s.
volumeType String: Volume type.

ServiceVolumeConfigurationManagedEbsVolumeTagSpecification, ServiceVolumeConfigurationManagedEbsVolumeTagSpecificationArgs

ResourceType string: The type of volume resource. Valid values, volume.
PropagateTags string: Determines whether to propagate the tags from the task definition to the Amazon EBS volume.
Tags Dictionary<string, string>: The tags applied to this Amazon EBS volume. AmazonECSCreated and AmazonECSManaged are reserved tags that can't be used.

ResourceType string: The type of volume resource. Valid values, volume.
PropagateTags string: Determines whether to propagate the tags from the task definition to the Amazon EBS volume.
Tags map[string]string: The tags applied to this Amazon EBS volume. AmazonECSCreated and AmazonECSManaged are reserved tags that can't be used.

resourceType String: The type of volume resource. Valid values, volume.
propagateTags String: Determines whether to propagate the tags from the task definition to the Amazon EBS volume.
tags Map<String,String>: The tags applied to this Amazon EBS volume. AmazonECSCreated and AmazonECSManaged are reserved tags that can't be used.

resourceType string: The type of volume resource. Valid values, volume.
propagateTags string: Determines whether to propagate the tags from the task definition to the Amazon EBS volume.
tags {[key: string]: string}: The tags applied to this Amazon EBS volume. AmazonECSCreated and AmazonECSManaged are reserved tags that can't be used.

resource_type str: The type of volume resource. Valid values, volume.
propagate_tags str: Determines whether to propagate the tags from the task definition to the Amazon EBS volume.
tags Mapping[str, str]: The tags applied to this Amazon EBS volume. AmazonECSCreated and AmazonECSManaged are reserved tags that can't be used.

resourceType String: The type of volume resource. Valid values, volume.
propagateTags String: Determines whether to propagate the tags from the task definition to the Amazon EBS volume.
tags Map<String>: The tags applied to this Amazon EBS volume. AmazonECSCreated and AmazonECSManaged are reserved tags that can't be used.

ServiceVpcLatticeConfiguration, ServiceVpcLatticeConfigurationArgs

PortName string: The name of the port for a target group associated with the VPC Lattice configuration.
RoleArn string: The ARN of the IAM role to associate with this volume. This is the Amazon ECS infrastructure IAM role that is used to manage your AWS infrastructure.
TargetGroupArn string: The full ARN of the target group or groups associated with the VPC Lattice configuration.

PortName string: The name of the port for a target group associated with the VPC Lattice configuration.
RoleArn string: The ARN of the IAM role to associate with this volume. This is the Amazon ECS infrastructure IAM role that is used to manage your AWS infrastructure.
TargetGroupArn string: The full ARN of the target group or groups associated with the VPC Lattice configuration.

portName String: The name of the port for a target group associated with the VPC Lattice configuration.
roleArn String: The ARN of the IAM role to associate with this volume. This is the Amazon ECS infrastructure IAM role that is used to manage your AWS infrastructure.
targetGroupArn String: The full ARN of the target group or groups associated with the VPC Lattice configuration.

portName string: The name of the port for a target group associated with the VPC Lattice configuration.
roleArn string: The ARN of the IAM role to associate with this volume. This is the Amazon ECS infrastructure IAM role that is used to manage your AWS infrastructure.
targetGroupArn string: The full ARN of the target group or groups associated with the VPC Lattice configuration.

port_name str: The name of the port for a target group associated with the VPC Lattice configuration.
role_arn str: The ARN of the IAM role to associate with this volume. This is the Amazon ECS infrastructure IAM role that is used to manage your AWS infrastructure.
target_group_arn str: The full ARN of the target group or groups associated with the VPC Lattice configuration.

portName String: The name of the port for a target group associated with the VPC Lattice configuration.
roleArn String: The ARN of the IAM role to associate with this volume. This is the Amazon ECS infrastructure IAM role that is used to manage your AWS infrastructure.
targetGroupArn String: The full ARN of the target group or groups associated with the VPC Lattice configuration.

Import

Using pulumi import, import ECS services using the name together with ecs cluster name. For example:

$ pulumi import aws:ecs/service:Service imported cluster-name/service-name

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 v6.73.0 published on Wednesday, Mar 19, 2025 by Pulumi

pulumi/pulumi-aws

aws.ecs.Service

On this page

On this page

Example Usage

Ignoring Changes to Desired Count

Daemon Scheduling Strategy

CloudWatch Deployment Alarms

External Deployment Controller

Redeploy Service On Every Apply

Create Service Resource

Constructor syntax

Parameters

Constructor example

Service Resource Properties

Inputs

Outputs

Look up Existing Service Resource

Supporting Types

ServiceAlarms, ServiceAlarmsArgs

ServiceCapacityProviderStrategy, ServiceCapacityProviderStrategyArgs

ServiceDeploymentCircuitBreaker, ServiceDeploymentCircuitBreakerArgs

ServiceDeploymentController, ServiceDeploymentControllerArgs

ServiceLoadBalancer, ServiceLoadBalancerArgs

ServiceNetworkConfiguration, ServiceNetworkConfigurationArgs

ServiceOrderedPlacementStrategy, ServiceOrderedPlacementStrategyArgs

ServicePlacementConstraint, ServicePlacementConstraintArgs

ServiceServiceConnectConfiguration, ServiceServiceConnectConfigurationArgs

ServiceServiceConnectConfigurationLogConfiguration, ServiceServiceConnectConfigurationLogConfigurationArgs

ServiceServiceConnectConfigurationLogConfigurationSecretOption, ServiceServiceConnectConfigurationLogConfigurationSecretOptionArgs

ServiceServiceConnectConfigurationService, ServiceServiceConnectConfigurationServiceArgs

ServiceServiceConnectConfigurationServiceClientAlias, ServiceServiceConnectConfigurationServiceClientAliasArgs

ServiceServiceConnectConfigurationServiceTimeout, ServiceServiceConnectConfigurationServiceTimeoutArgs

ServiceServiceConnectConfigurationServiceTls, ServiceServiceConnectConfigurationServiceTlsArgs

ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthority, ServiceServiceConnectConfigurationServiceTlsIssuerCertAuthorityArgs

ServiceServiceRegistries, ServiceServiceRegistriesArgs

ServiceVolumeConfiguration, ServiceVolumeConfigurationArgs

ServiceVolumeConfigurationManagedEbsVolume, ServiceVolumeConfigurationManagedEbsVolumeArgs

ServiceVolumeConfigurationManagedEbsVolumeTagSpecification, ServiceVolumeConfigurationManagedEbsVolumeTagSpecificationArgs

ServiceVpcLatticeConfiguration, ServiceVpcLatticeConfigurationArgs

Import

Package Details

On this page

On this page