1. Packages
  2. AWS
  3. API Docs
  4. ecs
  5. getService
Viewing docs for AWS v7.22.0
published on Wednesday, Mar 11, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

aws.ecs.getService

aws logo
Viewing docs for AWS v7.22.0
published on Wednesday, Mar 11, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

    The ECS Service data source allows access to details of a specific Service within a AWS ECS Cluster.

    Example Usage

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

const example = aws.ecs.getService({
    serviceName: "example",
    clusterArn: exampleAwsEcsCluster.arn,
});

    import pulumi
import pulumi_aws as aws

example = aws.ecs.get_service(service_name="example",
    cluster_arn=example_aws_ecs_cluster["arn"])

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ecs"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ecs.LookupService(ctx, &ecs.LookupServiceArgs{
			ServiceName: "example",
			ClusterArn:  exampleAwsEcsCluster.Arn,
		}, nil)
		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 = Aws.Ecs.GetService.Invoke(new()
    {
        ServiceName = "example",
        ClusterArn = exampleAwsEcsCluster.Arn,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.EcsFunctions;
import com.pulumi.aws.ecs.inputs.GetServiceArgs;
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) {
        final var example = EcsFunctions.getService(GetServiceArgs.builder()
            .serviceName("example")
            .clusterArn(exampleAwsEcsCluster.arn())
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: aws:ecs:getService
      arguments:
        serviceName: example
        clusterArn: ${exampleAwsEcsCluster.arn}

    Using getService

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getService(args: GetServiceArgs, opts?: InvokeOptions): Promise<GetServiceResult>
function getServiceOutput(args: GetServiceOutputArgs, opts?: InvokeOptions): Output<GetServiceResult>
    def get_service(cluster_arn: Optional[str] = None,
                region: Optional[str] = None,
                service_name: Optional[str] = None,
                tags: Optional[Mapping[str, str]] = None,
                opts: Optional[InvokeOptions] = None) -> GetServiceResult
def get_service_output(cluster_arn: Optional[pulumi.Input[str]] = None,
                region: Optional[pulumi.Input[str]] = None,
                service_name: Optional[pulumi.Input[str]] = None,
                tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetServiceResult]
    func LookupService(ctx *Context, args *LookupServiceArgs, opts ...InvokeOption) (*LookupServiceResult, error)
func LookupServiceOutput(ctx *Context, args *LookupServiceOutputArgs, opts ...InvokeOption) LookupServiceResultOutput

    > Note: This function is named LookupService in the Go SDK.

    public static class GetService 
{
    public static Task<GetServiceResult> InvokeAsync(GetServiceArgs args, InvokeOptions? opts = null)
    public static Output<GetServiceResult> Invoke(GetServiceInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetServiceResult> getService(GetServiceArgs args, InvokeOptions options)
public static Output<GetServiceResult> getService(GetServiceArgs args, InvokeOptions options)

    fn::invoke:
  function: aws:ecs/getService:getService
  arguments:
    # arguments dictionary

    The following arguments are supported:

    ClusterArn string
    ARN of the ECS Cluster
    ServiceName string
    Name of the ECS Service
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags Dictionary<string, string>
    Resource tags.
    ClusterArn string
    ARN of the ECS Cluster
    ServiceName string
    Name of the ECS Service
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags map[string]string
    Resource tags.
    clusterArn String
    ARN of the ECS Cluster
    serviceName String
    Name of the ECS Service
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String,String>
    Resource tags.
    clusterArn string
    ARN of the ECS Cluster
    serviceName string
    Name of the ECS Service
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags {[key: string]: string}
    Resource tags.
    cluster_arn str
    ARN of the ECS Cluster
    service_name str
    Name of the ECS Service
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Mapping[str, str]
    Resource tags.
    clusterArn String
    ARN of the ECS Cluster
    serviceName String
    Name of the ECS Service
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String>
    Resource tags.

    getService Result

    The following output properties are available:

    Arn string
    ARN of the task set
    AvailabilityZoneRebalancing string
    Whether Availability Zone rebalancing is enabled
    CapacityProviderStrategies List<GetServiceCapacityProviderStrategy>
    Capacity provider strategy for the service. See capacity_provider_strategy Block for details.
    ClusterArn string
    CreatedAt string
    Time when task set was created (RFC3339 format)
    CreatedBy string
    Principal that created the service
    DeploymentConfigurations List<GetServiceDeploymentConfiguration>
    Deployment configuration for the service. See deployment_configuration Block for details.
    DeploymentControllers List<GetServiceDeploymentController>
    Deployment controller configuration. See deployment_controller Block for details.
    Deployments List<GetServiceDeployment>
    Current deployments for the service. See deployments Block for details.
    DesiredCount int
    Desired number of tasks
    EnableEcsManagedTags bool
    Whether ECS managed tags are enabled
    EnableExecuteCommand bool
    Whether execute command functionality is enabled
    Events List<GetServiceEvent>
    Recent service events. See events Block for details.
    HealthCheckGracePeriodSeconds int
    Grace period for health checks
    IamRole string
    ARN of the IAM role associated with the service
    Id string
    The provider-assigned unique ID for this managed resource.
    LaunchType string
    Launch type for the ECS Service
    LoadBalancers List<GetServiceLoadBalancer>
    Load balancers for the ECS Service. See load_balancer Block for details.
    NetworkConfigurations List<GetServiceNetworkConfiguration>
    Network configuration for the service. See network_configuration Block for details.
    OrderedPlacementStrategies List<GetServiceOrderedPlacementStrategy>
    Placement strategy for tasks. See ordered_placement_strategy Block for details.
    PendingCount int
    Number of pending tasks
    PlacementConstraints List<GetServicePlacementConstraint>
    Placement constraints for tasks. See placement_constraints Block for details.
    PlatformFamily string
    Platform family for Fargate tasks
    PlatformVersion string
    Platform version for Fargate tasks
    PropagateTags string
    Whether tags are propagated from task definition or service
    Region string
    RunningCount int
    Number of running tasks
    SchedulingStrategy string
    Scheduling strategy for the ECS Service
    ServiceName string
    ServiceRegistries List<GetServiceServiceRegistry>
    Service discovery registries. See service_registries Block for details.
    Status string
    Task set status
    Tags Dictionary<string, string>
    Resource tags.
    TaskDefinition string
    Task definition ARN
    TaskSets List<GetServiceTaskSet>
    Task sets for the service. See task_sets Block for details.
    Arn string
    ARN of the task set
    AvailabilityZoneRebalancing string
    Whether Availability Zone rebalancing is enabled
    CapacityProviderStrategies []GetServiceCapacityProviderStrategy
    Capacity provider strategy for the service. See capacity_provider_strategy Block for details.
    ClusterArn string
    CreatedAt string
    Time when task set was created (RFC3339 format)
    CreatedBy string
    Principal that created the service
    DeploymentConfigurations []GetServiceDeploymentConfiguration
    Deployment configuration for the service. See deployment_configuration Block for details.
    DeploymentControllers []GetServiceDeploymentController
    Deployment controller configuration. See deployment_controller Block for details.
    Deployments []GetServiceDeployment
    Current deployments for the service. See deployments Block for details.
    DesiredCount int
    Desired number of tasks
    EnableEcsManagedTags bool
    Whether ECS managed tags are enabled
    EnableExecuteCommand bool
    Whether execute command functionality is enabled
    Events []GetServiceEvent
    Recent service events. See events Block for details.
    HealthCheckGracePeriodSeconds int
    Grace period for health checks
    IamRole string
    ARN of the IAM role associated with the service
    Id string
    The provider-assigned unique ID for this managed resource.
    LaunchType string
    Launch type for the ECS Service
    LoadBalancers []GetServiceLoadBalancer
    Load balancers for the ECS Service. See load_balancer Block for details.
    NetworkConfigurations []GetServiceNetworkConfiguration
    Network configuration for the service. See network_configuration Block for details.
    OrderedPlacementStrategies []GetServiceOrderedPlacementStrategy
    Placement strategy for tasks. See ordered_placement_strategy Block for details.
    PendingCount int
    Number of pending tasks
    PlacementConstraints []GetServicePlacementConstraint
    Placement constraints for tasks. See placement_constraints Block for details.
    PlatformFamily string
    Platform family for Fargate tasks
    PlatformVersion string
    Platform version for Fargate tasks
    PropagateTags string
    Whether tags are propagated from task definition or service
    Region string
    RunningCount int
    Number of running tasks
    SchedulingStrategy string
    Scheduling strategy for the ECS Service
    ServiceName string
    ServiceRegistries []GetServiceServiceRegistry
    Service discovery registries. See service_registries Block for details.
    Status string
    Task set status
    Tags map[string]string
    Resource tags.
    TaskDefinition string
    Task definition ARN
    TaskSets []GetServiceTaskSet
    Task sets for the service. See task_sets Block for details.
    arn String
    ARN of the task set
    availabilityZoneRebalancing String
    Whether Availability Zone rebalancing is enabled
    capacityProviderStrategies List<GetServiceCapacityProviderStrategy>
    Capacity provider strategy for the service. See capacity_provider_strategy Block for details.
    clusterArn String
    createdAt String
    Time when task set was created (RFC3339 format)
    createdBy String
    Principal that created the service
    deploymentConfigurations List<GetServiceDeploymentConfiguration>
    Deployment configuration for the service. See deployment_configuration Block for details.
    deploymentControllers List<GetServiceDeploymentController>
    Deployment controller configuration. See deployment_controller Block for details.
    deployments List<GetServiceDeployment>
    Current deployments for the service. See deployments Block for details.
    desiredCount Integer
    Desired number of tasks
    enableEcsManagedTags Boolean
    Whether ECS managed tags are enabled
    enableExecuteCommand Boolean
    Whether execute command functionality is enabled
    events List<GetServiceEvent>
    Recent service events. See events Block for details.
    healthCheckGracePeriodSeconds Integer
    Grace period for health checks
    iamRole String
    ARN of the IAM role associated with the service
    id String
    The provider-assigned unique ID for this managed resource.
    launchType String
    Launch type for the ECS Service
    loadBalancers List<GetServiceLoadBalancer>
    Load balancers for the ECS Service. See load_balancer Block for details.
    networkConfigurations List<GetServiceNetworkConfiguration>
    Network configuration for the service. See network_configuration Block for details.
    orderedPlacementStrategies List<GetServiceOrderedPlacementStrategy>
    Placement strategy for tasks. See ordered_placement_strategy Block for details.
    pendingCount Integer
    Number of pending tasks
    placementConstraints List<GetServicePlacementConstraint>
    Placement constraints for tasks. See placement_constraints Block for details.
    platformFamily String
    Platform family for Fargate tasks
    platformVersion String
    Platform version for Fargate tasks
    propagateTags String
    Whether tags are propagated from task definition or service
    region String
    runningCount Integer
    Number of running tasks
    schedulingStrategy String
    Scheduling strategy for the ECS Service
    serviceName String
    serviceRegistries List<GetServiceServiceRegistry>
    Service discovery registries. See service_registries Block for details.
    status String
    Task set status
    tags Map<String,String>
    Resource tags.
    taskDefinition String
    Task definition ARN
    taskSets List<GetServiceTaskSet>
    Task sets for the service. See task_sets Block for details.
    arn string
    ARN of the task set
    availabilityZoneRebalancing string
    Whether Availability Zone rebalancing is enabled
    capacityProviderStrategies GetServiceCapacityProviderStrategy[]
    Capacity provider strategy for the service. See capacity_provider_strategy Block for details.
    clusterArn string
    createdAt string
    Time when task set was created (RFC3339 format)
    createdBy string
    Principal that created the service
    deploymentConfigurations GetServiceDeploymentConfiguration[]
    Deployment configuration for the service. See deployment_configuration Block for details.
    deploymentControllers GetServiceDeploymentController[]
    Deployment controller configuration. See deployment_controller Block for details.
    deployments GetServiceDeployment[]
    Current deployments for the service. See deployments Block for details.
    desiredCount number
    Desired number of tasks
    enableEcsManagedTags boolean
    Whether ECS managed tags are enabled
    enableExecuteCommand boolean
    Whether execute command functionality is enabled
    events GetServiceEvent[]
    Recent service events. See events Block for details.
    healthCheckGracePeriodSeconds number
    Grace period for health checks
    iamRole string
    ARN of the IAM role associated with the service
    id string
    The provider-assigned unique ID for this managed resource.
    launchType string
    Launch type for the ECS Service
    loadBalancers GetServiceLoadBalancer[]
    Load balancers for the ECS Service. See load_balancer Block for details.
    networkConfigurations GetServiceNetworkConfiguration[]
    Network configuration for the service. See network_configuration Block for details.
    orderedPlacementStrategies GetServiceOrderedPlacementStrategy[]
    Placement strategy for tasks. See ordered_placement_strategy Block for details.
    pendingCount number
    Number of pending tasks
    placementConstraints GetServicePlacementConstraint[]
    Placement constraints for tasks. See placement_constraints Block for details.
    platformFamily string
    Platform family for Fargate tasks
    platformVersion string
    Platform version for Fargate tasks
    propagateTags string
    Whether tags are propagated from task definition or service
    region string
    runningCount number
    Number of running tasks
    schedulingStrategy string
    Scheduling strategy for the ECS Service
    serviceName string
    serviceRegistries GetServiceServiceRegistry[]
    Service discovery registries. See service_registries Block for details.
    status string
    Task set status
    tags {[key: string]: string}
    Resource tags.
    taskDefinition string
    Task definition ARN
    taskSets GetServiceTaskSet[]
    Task sets for the service. See task_sets Block for details.
    arn str
    ARN of the task set
    availability_zone_rebalancing str
    Whether Availability Zone rebalancing is enabled
    capacity_provider_strategies Sequence[GetServiceCapacityProviderStrategy]
    Capacity provider strategy for the service. See capacity_provider_strategy Block for details.
    cluster_arn str
    created_at str
    Time when task set was created (RFC3339 format)
    created_by str
    Principal that created the service
    deployment_configurations Sequence[GetServiceDeploymentConfiguration]
    Deployment configuration for the service. See deployment_configuration Block for details.
    deployment_controllers Sequence[GetServiceDeploymentController]
    Deployment controller configuration. See deployment_controller Block for details.
    deployments Sequence[GetServiceDeployment]
    Current deployments for the service. See deployments Block for details.
    desired_count int
    Desired number of tasks
    enable_ecs_managed_tags bool
    Whether ECS managed tags are enabled
    enable_execute_command bool
    Whether execute command functionality is enabled
    events Sequence[GetServiceEvent]
    Recent service events. See events Block for details.
    health_check_grace_period_seconds int
    Grace period for health checks
    iam_role str
    ARN of the IAM role associated with the service
    id str
    The provider-assigned unique ID for this managed resource.
    launch_type str
    Launch type for the ECS Service
    load_balancers Sequence[GetServiceLoadBalancer]
    Load balancers for the ECS Service. See load_balancer Block for details.
    network_configurations Sequence[GetServiceNetworkConfiguration]
    Network configuration for the service. See network_configuration Block for details.
    ordered_placement_strategies Sequence[GetServiceOrderedPlacementStrategy]
    Placement strategy for tasks. See ordered_placement_strategy Block for details.
    pending_count int
    Number of pending tasks
    placement_constraints Sequence[GetServicePlacementConstraint]
    Placement constraints for tasks. See placement_constraints Block for details.
    platform_family str
    Platform family for Fargate tasks
    platform_version str
    Platform version for Fargate tasks
    propagate_tags str
    Whether tags are propagated from task definition or service
    region str
    running_count int
    Number of running tasks
    scheduling_strategy str
    Scheduling strategy for the ECS Service
    service_name str
    service_registries Sequence[GetServiceServiceRegistry]
    Service discovery registries. See service_registries Block for details.
    status str
    Task set status
    tags Mapping[str, str]
    Resource tags.
    task_definition str
    Task definition ARN
    task_sets Sequence[GetServiceTaskSet]
    Task sets for the service. See task_sets Block for details.
    arn String
    ARN of the task set
    availabilityZoneRebalancing String
    Whether Availability Zone rebalancing is enabled
    capacityProviderStrategies List<Property Map>
    Capacity provider strategy for the service. See capacity_provider_strategy Block for details.
    clusterArn String
    createdAt String
    Time when task set was created (RFC3339 format)
    createdBy String
    Principal that created the service
    deploymentConfigurations List<Property Map>
    Deployment configuration for the service. See deployment_configuration Block for details.
    deploymentControllers List<Property Map>
    Deployment controller configuration. See deployment_controller Block for details.
    deployments List<Property Map>
    Current deployments for the service. See deployments Block for details.
    desiredCount Number
    Desired number of tasks
    enableEcsManagedTags Boolean
    Whether ECS managed tags are enabled
    enableExecuteCommand Boolean
    Whether execute command functionality is enabled
    events List<Property Map>
    Recent service events. See events Block for details.
    healthCheckGracePeriodSeconds Number
    Grace period for health checks
    iamRole String
    ARN of the IAM role associated with the service
    id String
    The provider-assigned unique ID for this managed resource.
    launchType String
    Launch type for the ECS Service
    loadBalancers List<Property Map>
    Load balancers for the ECS Service. See load_balancer Block for details.
    networkConfigurations List<Property Map>
    Network configuration for the service. See network_configuration Block for details.
    orderedPlacementStrategies List<Property Map>
    Placement strategy for tasks. See ordered_placement_strategy Block for details.
    pendingCount Number
    Number of pending tasks
    placementConstraints List<Property Map>
    Placement constraints for tasks. See placement_constraints Block for details.
    platformFamily String
    Platform family for Fargate tasks
    platformVersion String
    Platform version for Fargate tasks
    propagateTags String
    Whether tags are propagated from task definition or service
    region String
    runningCount Number
    Number of running tasks
    schedulingStrategy String
    Scheduling strategy for the ECS Service
    serviceName String
    serviceRegistries List<Property Map>
    Service discovery registries. See service_registries Block for details.
    status String
    Task set status
    tags Map<String>
    Resource tags.
    taskDefinition String
    Task definition ARN
    taskSets List<Property Map>
    Task sets for the service. See task_sets Block for details.

    Supporting Types

    GetServiceCapacityProviderStrategy

    Base int
    Number of tasks using the specified capacity provider
    CapacityProvider string
    Name of the capacity provider
    Weight int
    Relative percentage of total tasks to launch
    Base int
    Number of tasks using the specified capacity provider
    CapacityProvider string
    Name of the capacity provider
    Weight int
    Relative percentage of total tasks to launch
    base Integer
    Number of tasks using the specified capacity provider
    capacityProvider String
    Name of the capacity provider
    weight Integer
    Relative percentage of total tasks to launch
    base number
    Number of tasks using the specified capacity provider
    capacityProvider string
    Name of the capacity provider
    weight number
    Relative percentage of total tasks to launch
    base int
    Number of tasks using the specified capacity provider
    capacity_provider str
    Name of the capacity provider
    weight int
    Relative percentage of total tasks to launch
    base Number
    Number of tasks using the specified capacity provider
    capacityProvider String
    Name of the capacity provider
    weight Number
    Relative percentage of total tasks to launch

    GetServiceDeployment

    CreatedAt string
    Time when task set was created (RFC3339 format)
    DesiredCount int
    Desired number of tasks
    Id string
    Task set ID
    PendingCount int
    Number of pending tasks
    RunningCount int
    Number of running tasks
    Status string
    Task set status
    TaskDefinition string
    Task definition ARN
    UpdatedAt string
    Time when task set was last updated (RFC3339 format)
    CreatedAt string
    Time when task set was created (RFC3339 format)
    DesiredCount int
    Desired number of tasks
    Id string
    Task set ID
    PendingCount int
    Number of pending tasks
    RunningCount int
    Number of running tasks
    Status string
    Task set status
    TaskDefinition string
    Task definition ARN
    UpdatedAt string
    Time when task set was last updated (RFC3339 format)
    createdAt String
    Time when task set was created (RFC3339 format)
    desiredCount Integer
    Desired number of tasks
    id String
    Task set ID
    pendingCount Integer
    Number of pending tasks
    runningCount Integer
    Number of running tasks
    status String
    Task set status
    taskDefinition String
    Task definition ARN
    updatedAt String
    Time when task set was last updated (RFC3339 format)
    createdAt string
    Time when task set was created (RFC3339 format)
    desiredCount number
    Desired number of tasks
    id string
    Task set ID
    pendingCount number
    Number of pending tasks
    runningCount number
    Number of running tasks
    status string
    Task set status
    taskDefinition string
    Task definition ARN
    updatedAt string
    Time when task set was last updated (RFC3339 format)
    created_at str
    Time when task set was created (RFC3339 format)
    desired_count int
    Desired number of tasks
    id str
    Task set ID
    pending_count int
    Number of pending tasks
    running_count int
    Number of running tasks
    status str
    Task set status
    task_definition str
    Task definition ARN
    updated_at str
    Time when task set was last updated (RFC3339 format)
    createdAt String
    Time when task set was created (RFC3339 format)
    desiredCount Number
    Desired number of tasks
    id String
    Task set ID
    pendingCount Number
    Number of pending tasks
    runningCount Number
    Number of running tasks
    status String
    Task set status
    taskDefinition String
    Task definition ARN
    updatedAt String
    Time when task set was last updated (RFC3339 format)

    GetServiceDeploymentConfiguration

    Alarms List<GetServiceDeploymentConfigurationAlarm>
    CloudWatch alarms configuration. See alarms Block for details.
    BakeTimeInMinutes string
    Time to wait after deployment before terminating old tasks
    CanaryConfigurations List<GetServiceDeploymentConfigurationCanaryConfiguration>
    Canary deployment configuration. See canary_configuration Block for details.
    DeploymentCircuitBreakers List<GetServiceDeploymentConfigurationDeploymentCircuitBreaker>
    Circuit breaker configuration. See deployment_circuit_breaker Block for details.
    LifecycleHooks List<GetServiceDeploymentConfigurationLifecycleHook>
    Lifecycle hooks for deployments. See lifecycle_hook Block for details.
    LinearConfigurations List<GetServiceDeploymentConfigurationLinearConfiguration>
    Linear deployment configuration. See linear_configuration Block for details.
    MaximumPercent int
    Upper limit on tasks during deployment
    MinimumHealthyPercent int
    Lower limit on healthy tasks during deployment
    Strategy string
    Deployment strategy (ROLLING, BLUE_GREEN, LINEAR, or CANARY)
    Alarms []GetServiceDeploymentConfigurationAlarm
    CloudWatch alarms configuration. See alarms Block for details.
    BakeTimeInMinutes string
    Time to wait after deployment before terminating old tasks
    CanaryConfigurations []GetServiceDeploymentConfigurationCanaryConfiguration
    Canary deployment configuration. See canary_configuration Block for details.
    DeploymentCircuitBreakers []GetServiceDeploymentConfigurationDeploymentCircuitBreaker
    Circuit breaker configuration. See deployment_circuit_breaker Block for details.
    LifecycleHooks []GetServiceDeploymentConfigurationLifecycleHook
    Lifecycle hooks for deployments. See lifecycle_hook Block for details.
    LinearConfigurations []GetServiceDeploymentConfigurationLinearConfiguration
    Linear deployment configuration. See linear_configuration Block for details.
    MaximumPercent int
    Upper limit on tasks during deployment
    MinimumHealthyPercent int
    Lower limit on healthy tasks during deployment
    Strategy string
    Deployment strategy (ROLLING, BLUE_GREEN, LINEAR, or CANARY)
    alarms List<GetServiceDeploymentConfigurationAlarm>
    CloudWatch alarms configuration. See alarms Block for details.
    bakeTimeInMinutes String
    Time to wait after deployment before terminating old tasks
    canaryConfigurations List<GetServiceDeploymentConfigurationCanaryConfiguration>
    Canary deployment configuration. See canary_configuration Block for details.
    deploymentCircuitBreakers List<GetServiceDeploymentConfigurationDeploymentCircuitBreaker>
    Circuit breaker configuration. See deployment_circuit_breaker Block for details.
    lifecycleHooks List<GetServiceDeploymentConfigurationLifecycleHook>
    Lifecycle hooks for deployments. See lifecycle_hook Block for details.
    linearConfigurations List<GetServiceDeploymentConfigurationLinearConfiguration>
    Linear deployment configuration. See linear_configuration Block for details.
    maximumPercent Integer
    Upper limit on tasks during deployment
    minimumHealthyPercent Integer
    Lower limit on healthy tasks during deployment
    strategy String
    Deployment strategy (ROLLING, BLUE_GREEN, LINEAR, or CANARY)
    alarms GetServiceDeploymentConfigurationAlarm[]
    CloudWatch alarms configuration. See alarms Block for details.
    bakeTimeInMinutes string
    Time to wait after deployment before terminating old tasks
    canaryConfigurations GetServiceDeploymentConfigurationCanaryConfiguration[]
    Canary deployment configuration. See canary_configuration Block for details.
    deploymentCircuitBreakers GetServiceDeploymentConfigurationDeploymentCircuitBreaker[]
    Circuit breaker configuration. See deployment_circuit_breaker Block for details.
    lifecycleHooks GetServiceDeploymentConfigurationLifecycleHook[]
    Lifecycle hooks for deployments. See lifecycle_hook Block for details.
    linearConfigurations GetServiceDeploymentConfigurationLinearConfiguration[]
    Linear deployment configuration. See linear_configuration Block for details.
    maximumPercent number
    Upper limit on tasks during deployment
    minimumHealthyPercent number
    Lower limit on healthy tasks during deployment
    strategy string
    Deployment strategy (ROLLING, BLUE_GREEN, LINEAR, or CANARY)
    alarms Sequence[GetServiceDeploymentConfigurationAlarm]
    CloudWatch alarms configuration. See alarms Block for details.
    bake_time_in_minutes str
    Time to wait after deployment before terminating old tasks
    canary_configurations Sequence[GetServiceDeploymentConfigurationCanaryConfiguration]
    Canary deployment configuration. See canary_configuration Block for details.
    deployment_circuit_breakers Sequence[GetServiceDeploymentConfigurationDeploymentCircuitBreaker]
    Circuit breaker configuration. See deployment_circuit_breaker Block for details.
    lifecycle_hooks Sequence[GetServiceDeploymentConfigurationLifecycleHook]
    Lifecycle hooks for deployments. See lifecycle_hook Block for details.
    linear_configurations Sequence[GetServiceDeploymentConfigurationLinearConfiguration]
    Linear deployment configuration. See linear_configuration Block for details.
    maximum_percent int
    Upper limit on tasks during deployment
    minimum_healthy_percent int
    Lower limit on healthy tasks during deployment
    strategy str
    Deployment strategy (ROLLING, BLUE_GREEN, LINEAR, or CANARY)
    alarms List<Property Map>
    CloudWatch alarms configuration. See alarms Block for details.
    bakeTimeInMinutes String
    Time to wait after deployment before terminating old tasks
    canaryConfigurations List<Property Map>
    Canary deployment configuration. See canary_configuration Block for details.
    deploymentCircuitBreakers List<Property Map>
    Circuit breaker configuration. See deployment_circuit_breaker Block for details.
    lifecycleHooks List<Property Map>
    Lifecycle hooks for deployments. See lifecycle_hook Block for details.
    linearConfigurations List<Property Map>
    Linear deployment configuration. See linear_configuration Block for details.
    maximumPercent Number
    Upper limit on tasks during deployment
    minimumHealthyPercent Number
    Lower limit on healthy tasks during deployment
    strategy String
    Deployment strategy (ROLLING, BLUE_GREEN, LINEAR, or CANARY)

    GetServiceDeploymentConfigurationAlarm

    AlarmNames List<string>
    List of CloudWatch alarm names
    Enable bool
    Whether circuit breaker is enabled
    Rollback bool
    Whether to rollback on failure
    AlarmNames []string
    List of CloudWatch alarm names
    Enable bool
    Whether circuit breaker is enabled
    Rollback bool
    Whether to rollback on failure
    alarmNames List<String>
    List of CloudWatch alarm names
    enable Boolean
    Whether circuit breaker is enabled
    rollback Boolean
    Whether to rollback on failure
    alarmNames string[]
    List of CloudWatch alarm names
    enable boolean
    Whether circuit breaker is enabled
    rollback boolean
    Whether to rollback on failure
    alarm_names Sequence[str]
    List of CloudWatch alarm names
    enable bool
    Whether circuit breaker is enabled
    rollback bool
    Whether to rollback on failure
    alarmNames List<String>
    List of CloudWatch alarm names
    enable Boolean
    Whether circuit breaker is enabled
    rollback Boolean
    Whether to rollback on failure

    GetServiceDeploymentConfigurationCanaryConfiguration

    CanaryBakeTimeInMinutes string
    Time to wait before shifting remaining traffic
    CanaryPercent double
    Percentage of traffic to route to canary deployment
    CanaryBakeTimeInMinutes string
    Time to wait before shifting remaining traffic
    CanaryPercent float64
    Percentage of traffic to route to canary deployment
    canaryBakeTimeInMinutes String
    Time to wait before shifting remaining traffic
    canaryPercent Double
    Percentage of traffic to route to canary deployment
    canaryBakeTimeInMinutes string
    Time to wait before shifting remaining traffic
    canaryPercent number
    Percentage of traffic to route to canary deployment
    canary_bake_time_in_minutes str
    Time to wait before shifting remaining traffic
    canary_percent float
    Percentage of traffic to route to canary deployment
    canaryBakeTimeInMinutes String
    Time to wait before shifting remaining traffic
    canaryPercent Number
    Percentage of traffic to route to canary deployment

    GetServiceDeploymentConfigurationDeploymentCircuitBreaker

    Enable bool
    Whether circuit breaker is enabled
    Rollback bool
    Whether to rollback on failure
    Enable bool
    Whether circuit breaker is enabled
    Rollback bool
    Whether to rollback on failure
    enable Boolean
    Whether circuit breaker is enabled
    rollback Boolean
    Whether to rollback on failure
    enable boolean
    Whether circuit breaker is enabled
    rollback boolean
    Whether to rollback on failure
    enable bool
    Whether circuit breaker is enabled
    rollback bool
    Whether to rollback on failure
    enable Boolean
    Whether circuit breaker is enabled
    rollback Boolean
    Whether to rollback on failure

    GetServiceDeploymentConfigurationLifecycleHook

    HookDetails string
    Additional details for the hook
    HookTargetArn string
    ARN of the Lambda function to invoke
    LifecycleStages List<string>
    Deployment stages when hook is invoked
    RoleArn string
    ARN of the IAM role that allows ECS to manage the target groups.
    HookDetails string
    Additional details for the hook
    HookTargetArn string
    ARN of the Lambda function to invoke
    LifecycleStages []string
    Deployment stages when hook is invoked
    RoleArn string
    ARN of the IAM role that allows ECS to manage the target groups.
    hookDetails String
    Additional details for the hook
    hookTargetArn String
    ARN of the Lambda function to invoke
    lifecycleStages List<String>
    Deployment stages when hook is invoked
    roleArn String
    ARN of the IAM role that allows ECS to manage the target groups.
    hookDetails string
    Additional details for the hook
    hookTargetArn string
    ARN of the Lambda function to invoke
    lifecycleStages string[]
    Deployment stages when hook is invoked
    roleArn string
    ARN of the IAM role that allows ECS to manage the target groups.
    hook_details str
    Additional details for the hook
    hook_target_arn str
    ARN of the Lambda function to invoke
    lifecycle_stages Sequence[str]
    Deployment stages when hook is invoked
    role_arn str
    ARN of the IAM role that allows ECS to manage the target groups.
    hookDetails String
    Additional details for the hook
    hookTargetArn String
    ARN of the Lambda function to invoke
    lifecycleStages List<String>
    Deployment stages when hook is invoked
    roleArn String
    ARN of the IAM role that allows ECS to manage the target groups.

    GetServiceDeploymentConfigurationLinearConfiguration

    StepBakeTimeInMinutes string
    Time to wait between deployment steps
    StepPercent double
    Percentage of traffic to shift in each step
    StepBakeTimeInMinutes string
    Time to wait between deployment steps
    StepPercent float64
    Percentage of traffic to shift in each step
    stepBakeTimeInMinutes String
    Time to wait between deployment steps
    stepPercent Double
    Percentage of traffic to shift in each step
    stepBakeTimeInMinutes string
    Time to wait between deployment steps
    stepPercent number
    Percentage of traffic to shift in each step
    step_bake_time_in_minutes str
    Time to wait between deployment steps
    step_percent float
    Percentage of traffic to shift in each step
    stepBakeTimeInMinutes String
    Time to wait between deployment steps
    stepPercent Number
    Percentage of traffic to shift in each step

    GetServiceDeploymentController

    Type string
    Constraint type
    Type string
    Constraint type
    type String
    Constraint type
    type string
    Constraint type
    type str
    Constraint type
    type String
    Constraint type

    GetServiceEvent

    CreatedAt string
    Time when task set was created (RFC3339 format)
    Id string
    Task set ID
    Message string
    Event message
    CreatedAt string
    Time when task set was created (RFC3339 format)
    Id string
    Task set ID
    Message string
    Event message
    createdAt String
    Time when task set was created (RFC3339 format)
    id String
    Task set ID
    message String
    Event message
    createdAt string
    Time when task set was created (RFC3339 format)
    id string
    Task set ID
    message string
    Event message
    created_at str
    Time when task set was created (RFC3339 format)
    id str
    Task set ID
    message str
    Event message
    createdAt String
    Time when task set was created (RFC3339 format)
    id String
    Task set ID
    message String
    Event message

    GetServiceLoadBalancer

    AdvancedConfigurations List<GetServiceLoadBalancerAdvancedConfiguration>
    Settings for Blue/Green deployment. See advanced_configuration Block for details.
    ContainerName string
    Name of the container to associate with the load balancer.
    ContainerPort int
    Port on the container to associate with the load balancer.
    ElbName string
    Name of the load balancer.
    TargetGroupArn string
    ARN of the target group to associate with the load balancer.
    AdvancedConfigurations []GetServiceLoadBalancerAdvancedConfiguration
    Settings for Blue/Green deployment. See advanced_configuration Block for details.
    ContainerName string
    Name of the container to associate with the load balancer.
    ContainerPort int
    Port on the container to associate with the load balancer.
    ElbName string
    Name of the load balancer.
    TargetGroupArn string
    ARN of the target group to associate with the load balancer.
    advancedConfigurations List<GetServiceLoadBalancerAdvancedConfiguration>
    Settings for Blue/Green deployment. See advanced_configuration Block for details.
    containerName String
    Name of the container to associate with the load balancer.
    containerPort Integer
    Port on the container to associate with the load balancer.
    elbName String
    Name of the load balancer.
    targetGroupArn String
    ARN of the target group to associate with the load balancer.
    advancedConfigurations GetServiceLoadBalancerAdvancedConfiguration[]
    Settings for Blue/Green deployment. See advanced_configuration Block for details.
    containerName string
    Name of the container to associate with the load balancer.
    containerPort number
    Port on the container to associate with the load balancer.
    elbName string
    Name of the load balancer.
    targetGroupArn string
    ARN of the target group to associate with the load balancer.
    advanced_configurations Sequence[GetServiceLoadBalancerAdvancedConfiguration]
    Settings for Blue/Green deployment. See advanced_configuration Block for details.
    container_name str
    Name of the container to associate with the load balancer.
    container_port int
    Port on the container to associate with the load balancer.
    elb_name str
    Name of the load balancer.
    target_group_arn str
    ARN of the target group to associate with the load balancer.
    advancedConfigurations List<Property Map>
    Settings for Blue/Green deployment. See advanced_configuration Block for details.
    containerName String
    Name of the container to associate with the load balancer.
    containerPort Number
    Port on the container to associate with the load balancer.
    elbName String
    Name of the load balancer.
    targetGroupArn String
    ARN of the target group to associate with the load balancer.

    GetServiceLoadBalancerAdvancedConfiguration

    AlternateTargetGroupArn string
    ARN of the alternate target group to use for Blue/Green deployments.
    ProductionListenerRule string
    ARN of the listener rule that routes production traffic.
    RoleArn string
    ARN of the IAM role that allows ECS to manage the target groups.
    TestListenerRule string
    ARN of the listener rule that routes test traffic.
    AlternateTargetGroupArn string
    ARN of the alternate target group to use for Blue/Green deployments.
    ProductionListenerRule string
    ARN of the listener rule that routes production traffic.
    RoleArn string
    ARN of the IAM role that allows ECS to manage the target groups.
    TestListenerRule string
    ARN of the listener rule that routes test traffic.
    alternateTargetGroupArn String
    ARN of the alternate target group to use for Blue/Green deployments.
    productionListenerRule String
    ARN of the listener rule that routes production traffic.
    roleArn String
    ARN of the IAM role that allows ECS to manage the target groups.
    testListenerRule String
    ARN of the listener rule that routes test traffic.
    alternateTargetGroupArn string
    ARN of the alternate target group to use for Blue/Green deployments.
    productionListenerRule string
    ARN of the listener rule that routes production traffic.
    roleArn string
    ARN of the IAM role that allows ECS to manage the target groups.
    testListenerRule string
    ARN of the listener rule that routes test traffic.
    alternate_target_group_arn str
    ARN of the alternate target group to use for Blue/Green deployments.
    production_listener_rule str
    ARN of the listener rule that routes production traffic.
    role_arn str
    ARN of the IAM role that allows ECS to manage the target groups.
    test_listener_rule str
    ARN of the listener rule that routes test traffic.
    alternateTargetGroupArn String
    ARN of the alternate target group to use for Blue/Green deployments.
    productionListenerRule String
    ARN of the listener rule that routes production traffic.
    roleArn String
    ARN of the IAM role that allows ECS to manage the target groups.
    testListenerRule String
    ARN of the listener rule that routes test traffic.

    GetServiceNetworkConfiguration

    AssignPublicIp bool
    Whether tasks receive public IP addresses
    SecurityGroups List<string>
    Security groups associated with tasks
    Subnets List<string>
    Subnets associated with tasks
    AssignPublicIp bool
    Whether tasks receive public IP addresses
    SecurityGroups []string
    Security groups associated with tasks
    Subnets []string
    Subnets associated with tasks
    assignPublicIp Boolean
    Whether tasks receive public IP addresses
    securityGroups List<String>
    Security groups associated with tasks
    subnets List<String>
    Subnets associated with tasks
    assignPublicIp boolean
    Whether tasks receive public IP addresses
    securityGroups string[]
    Security groups associated with tasks
    subnets string[]
    Subnets associated with tasks
    assign_public_ip bool
    Whether tasks receive public IP addresses
    security_groups Sequence[str]
    Security groups associated with tasks
    subnets Sequence[str]
    Subnets associated with tasks
    assignPublicIp Boolean
    Whether tasks receive public IP addresses
    securityGroups List<String>
    Security groups associated with tasks
    subnets List<String>
    Subnets associated with tasks

    GetServiceOrderedPlacementStrategy

    Field string
    Field to apply placement strategy against
    Type string
    Constraint type
    Field string
    Field to apply placement strategy against
    Type string
    Constraint type
    field String
    Field to apply placement strategy against
    type String
    Constraint type
    field string
    Field to apply placement strategy against
    type string
    Constraint type
    field str
    Field to apply placement strategy against
    type str
    Constraint type
    field String
    Field to apply placement strategy against
    type String
    Constraint type

    GetServicePlacementConstraint

    Expression string
    Cluster query language expression
    Type string
    Constraint type
    Expression string
    Cluster query language expression
    Type string
    Constraint type
    expression String
    Cluster query language expression
    type String
    Constraint type
    expression string
    Cluster query language expression
    type string
    Constraint type
    expression str
    Cluster query language expression
    type str
    Constraint type
    expression String
    Cluster query language expression
    type String
    Constraint type

    GetServiceServiceRegistry

    ContainerName string
    Name of the container to associate with the load balancer.
    ContainerPort int
    Port on the container to associate with the load balancer.
    Port int
    Port value for service discovery
    RegistryArn string
    ARN of the service registry
    ContainerName string
    Name of the container to associate with the load balancer.
    ContainerPort int
    Port on the container to associate with the load balancer.
    Port int
    Port value for service discovery
    RegistryArn string
    ARN of the service registry
    containerName String
    Name of the container to associate with the load balancer.
    containerPort Integer
    Port on the container to associate with the load balancer.
    port Integer
    Port value for service discovery
    registryArn String
    ARN of the service registry
    containerName string
    Name of the container to associate with the load balancer.
    containerPort number
    Port on the container to associate with the load balancer.
    port number
    Port value for service discovery
    registryArn string
    ARN of the service registry
    container_name str
    Name of the container to associate with the load balancer.
    container_port int
    Port on the container to associate with the load balancer.
    port int
    Port value for service discovery
    registry_arn str
    ARN of the service registry
    containerName String
    Name of the container to associate with the load balancer.
    containerPort Number
    Port on the container to associate with the load balancer.
    port Number
    Port value for service discovery
    registryArn String
    ARN of the service registry

    GetServiceTaskSet

    Arn string
    ARN of the task set
    CreatedAt string
    Time when task set was created (RFC3339 format)
    Id string
    Task set ID
    PendingCount int
    Number of pending tasks
    RunningCount int
    Number of running tasks
    StabilityStatus string
    Stability status of the task set
    Status string
    Task set status
    TaskDefinition string
    Task definition ARN
    UpdatedAt string
    Time when task set was last updated (RFC3339 format)
    Arn string
    ARN of the task set
    CreatedAt string
    Time when task set was created (RFC3339 format)
    Id string
    Task set ID
    PendingCount int
    Number of pending tasks
    RunningCount int
    Number of running tasks
    StabilityStatus string
    Stability status of the task set
    Status string
    Task set status
    TaskDefinition string
    Task definition ARN
    UpdatedAt string
    Time when task set was last updated (RFC3339 format)
    arn String
    ARN of the task set
    createdAt String
    Time when task set was created (RFC3339 format)
    id String
    Task set ID
    pendingCount Integer
    Number of pending tasks
    runningCount Integer
    Number of running tasks
    stabilityStatus String
    Stability status of the task set
    status String
    Task set status
    taskDefinition String
    Task definition ARN
    updatedAt String
    Time when task set was last updated (RFC3339 format)
    arn string
    ARN of the task set
    createdAt string
    Time when task set was created (RFC3339 format)
    id string
    Task set ID
    pendingCount number
    Number of pending tasks
    runningCount number
    Number of running tasks
    stabilityStatus string
    Stability status of the task set
    status string
    Task set status
    taskDefinition string
    Task definition ARN
    updatedAt string
    Time when task set was last updated (RFC3339 format)
    arn str
    ARN of the task set
    created_at str
    Time when task set was created (RFC3339 format)
    id str
    Task set ID
    pending_count int
    Number of pending tasks
    running_count int
    Number of running tasks
    stability_status str
    Stability status of the task set
    status str
    Task set status
    task_definition str
    Task definition ARN
    updated_at str
    Time when task set was last updated (RFC3339 format)
    arn String
    ARN of the task set
    createdAt String
    Time when task set was created (RFC3339 format)
    id String
    Task set ID
    pendingCount Number
    Number of pending tasks
    runningCount Number
    Number of running tasks
    stabilityStatus String
    Stability status of the task set
    status String
    Task set status
    taskDefinition String
    Task definition ARN
    updatedAt String
    Time when task set was last updated (RFC3339 format)

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v7.22.0
    published on Wednesday, Mar 11, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws
      Try Pulumi Cloud free. Your team will thank you.