1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. ecs
  6. Daemon

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi
aws-native logo aws-native logo AWS Cloud Control

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi

    Information about a daemon resource.

    Create Daemon Resource

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

    Constructor syntax

    new Daemon(name: string, args?: DaemonArgs, opts?: CustomResourceOptions);
    @overload
    def Daemon(resource_name: str,
               args: Optional[DaemonArgs] = None,
               opts: Optional[ResourceOptions] = None)
    
    @overload
    def Daemon(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               capacity_provider_arns: Optional[Sequence[str]] = None,
               cluster_arn: Optional[str] = None,
               critical: Optional[bool] = None,
               daemon_name: Optional[str] = None,
               daemon_task_definition_arn: Optional[str] = None,
               deployment_configuration: Optional[DaemonDeploymentConfigurationArgs] = None,
               enable_ecs_managed_tags: Optional[bool] = None,
               enable_execute_command: Optional[bool] = None,
               propagate_tags: Optional[DaemonPropagateTags] = None,
               tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewDaemon(ctx *Context, name string, args *DaemonArgs, opts ...ResourceOption) (*Daemon, error)
    public Daemon(string name, DaemonArgs? args = null, CustomResourceOptions? opts = null)
    public Daemon(String name, DaemonArgs args)
    public Daemon(String name, DaemonArgs args, CustomResourceOptions options)
    
    type: aws-native:ecs:Daemon
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_ecs_daemon" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args DaemonArgs
    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 DaemonArgs
    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 DaemonArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DaemonArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DaemonArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

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

    CapacityProviderArns List<string>
    The Amazon Resource Names (ARNs) of the capacity providers associated with the daemon.
    ClusterArn string
    The Amazon Resource Name (ARN) of the cluster that the daemon is running in.
    Critical bool
    If the critical parameter of this daemon revision is true, and the daemon task fails, stops, or becomes unhealthy, Amazon ECS drains the container instance and stops the other tasks running on it. If the parameter is false, the daemon task failure doesn't affect the other tasks on the instance, and doesn't block instance registration. The default value is true.
    DaemonName string
    DaemonTaskDefinitionArn string
    The Amazon Resource Name (ARN) of the daemon task definition used by this revision.
    DeploymentConfiguration Pulumi.AwsNative.Ecs.Inputs.DaemonDeploymentConfiguration
    The deployment configuration used for this daemon deployment.
    EnableEcsManagedTags bool
    Specifies whether Amazon ECS managed tags are turned on for the daemon tasks.
    EnableExecuteCommand bool
    Specifies whether the execute command functionality is turned on for the daemon tasks.
    PropagateTags Pulumi.AwsNative.Ecs.DaemonPropagateTags
    Specifies whether tags are propagated from the daemon to the daemon tasks.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    CapacityProviderArns []string
    The Amazon Resource Names (ARNs) of the capacity providers associated with the daemon.
    ClusterArn string
    The Amazon Resource Name (ARN) of the cluster that the daemon is running in.
    Critical bool
    If the critical parameter of this daemon revision is true, and the daemon task fails, stops, or becomes unhealthy, Amazon ECS drains the container instance and stops the other tasks running on it. If the parameter is false, the daemon task failure doesn't affect the other tasks on the instance, and doesn't block instance registration. The default value is true.
    DaemonName string
    DaemonTaskDefinitionArn string
    The Amazon Resource Name (ARN) of the daemon task definition used by this revision.
    DeploymentConfiguration DaemonDeploymentConfigurationArgs
    The deployment configuration used for this daemon deployment.
    EnableEcsManagedTags bool
    Specifies whether Amazon ECS managed tags are turned on for the daemon tasks.
    EnableExecuteCommand bool
    Specifies whether the execute command functionality is turned on for the daemon tasks.
    PropagateTags DaemonPropagateTags
    Specifies whether tags are propagated from the daemon to the daemon tasks.
    Tags TagArgs
    capacity_provider_arns list(string)
    The Amazon Resource Names (ARNs) of the capacity providers associated with the daemon.
    cluster_arn string
    The Amazon Resource Name (ARN) of the cluster that the daemon is running in.
    critical bool
    If the critical parameter of this daemon revision is true, and the daemon task fails, stops, or becomes unhealthy, Amazon ECS drains the container instance and stops the other tasks running on it. If the parameter is false, the daemon task failure doesn't affect the other tasks on the instance, and doesn't block instance registration. The default value is true.
    daemon_name string
    daemon_task_definition_arn string
    The Amazon Resource Name (ARN) of the daemon task definition used by this revision.
    deployment_configuration object
    The deployment configuration used for this daemon deployment.
    enable_ecs_managed_tags bool
    Specifies whether Amazon ECS managed tags are turned on for the daemon tasks.
    enable_execute_command bool
    Specifies whether the execute command functionality is turned on for the daemon tasks.
    propagate_tags "DAEMON" | "NONE"
    Specifies whether tags are propagated from the daemon to the daemon tasks.
    tags list(object)
    capacityProviderArns List<String>
    The Amazon Resource Names (ARNs) of the capacity providers associated with the daemon.
    clusterArn String
    The Amazon Resource Name (ARN) of the cluster that the daemon is running in.
    critical Boolean
    If the critical parameter of this daemon revision is true, and the daemon task fails, stops, or becomes unhealthy, Amazon ECS drains the container instance and stops the other tasks running on it. If the parameter is false, the daemon task failure doesn't affect the other tasks on the instance, and doesn't block instance registration. The default value is true.
    daemonName String
    daemonTaskDefinitionArn String
    The Amazon Resource Name (ARN) of the daemon task definition used by this revision.
    deploymentConfiguration DaemonDeploymentConfiguration
    The deployment configuration used for this daemon deployment.
    enableEcsManagedTags Boolean
    Specifies whether Amazon ECS managed tags are turned on for the daemon tasks.
    enableExecuteCommand Boolean
    Specifies whether the execute command functionality is turned on for the daemon tasks.
    propagateTags DaemonPropagateTags
    Specifies whether tags are propagated from the daemon to the daemon tasks.
    tags List<Tag>
    capacityProviderArns string[]
    The Amazon Resource Names (ARNs) of the capacity providers associated with the daemon.
    clusterArn string
    The Amazon Resource Name (ARN) of the cluster that the daemon is running in.
    critical boolean
    If the critical parameter of this daemon revision is true, and the daemon task fails, stops, or becomes unhealthy, Amazon ECS drains the container instance and stops the other tasks running on it. If the parameter is false, the daemon task failure doesn't affect the other tasks on the instance, and doesn't block instance registration. The default value is true.
    daemonName string
    daemonTaskDefinitionArn string
    The Amazon Resource Name (ARN) of the daemon task definition used by this revision.
    deploymentConfiguration DaemonDeploymentConfiguration
    The deployment configuration used for this daemon deployment.
    enableEcsManagedTags boolean
    Specifies whether Amazon ECS managed tags are turned on for the daemon tasks.
    enableExecuteCommand boolean
    Specifies whether the execute command functionality is turned on for the daemon tasks.
    propagateTags DaemonPropagateTags
    Specifies whether tags are propagated from the daemon to the daemon tasks.
    tags Tag[]
    capacity_provider_arns Sequence[str]
    The Amazon Resource Names (ARNs) of the capacity providers associated with the daemon.
    cluster_arn str
    The Amazon Resource Name (ARN) of the cluster that the daemon is running in.
    critical bool
    If the critical parameter of this daemon revision is true, and the daemon task fails, stops, or becomes unhealthy, Amazon ECS drains the container instance and stops the other tasks running on it. If the parameter is false, the daemon task failure doesn't affect the other tasks on the instance, and doesn't block instance registration. The default value is true.
    daemon_name str
    daemon_task_definition_arn str
    The Amazon Resource Name (ARN) of the daemon task definition used by this revision.
    deployment_configuration DaemonDeploymentConfigurationArgs
    The deployment configuration used for this daemon deployment.
    enable_ecs_managed_tags bool
    Specifies whether Amazon ECS managed tags are turned on for the daemon tasks.
    enable_execute_command bool
    Specifies whether the execute command functionality is turned on for the daemon tasks.
    propagate_tags DaemonPropagateTags
    Specifies whether tags are propagated from the daemon to the daemon tasks.
    tags Sequence[TagArgs]
    capacityProviderArns List<String>
    The Amazon Resource Names (ARNs) of the capacity providers associated with the daemon.
    clusterArn String
    The Amazon Resource Name (ARN) of the cluster that the daemon is running in.
    critical Boolean
    If the critical parameter of this daemon revision is true, and the daemon task fails, stops, or becomes unhealthy, Amazon ECS drains the container instance and stops the other tasks running on it. If the parameter is false, the daemon task failure doesn't affect the other tasks on the instance, and doesn't block instance registration. The default value is true.
    daemonName String
    daemonTaskDefinitionArn String
    The Amazon Resource Name (ARN) of the daemon task definition used by this revision.
    deploymentConfiguration Property Map
    The deployment configuration used for this daemon deployment.
    enableEcsManagedTags Boolean
    Specifies whether Amazon ECS managed tags are turned on for the daemon tasks.
    enableExecuteCommand Boolean
    Specifies whether the execute command functionality is turned on for the daemon tasks.
    propagateTags "DAEMON" | "NONE"
    Specifies whether tags are propagated from the daemon to the daemon tasks.
    tags List<Property Map>

    Outputs

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

    CreatedAt string
    DaemonArn string
    DaemonStatus Pulumi.AwsNative.Ecs.DaemonStatus
    DeploymentArn string
    Id string
    The provider-assigned unique ID for this managed resource.
    UpdatedAt string
    CreatedAt string
    DaemonArn string
    DaemonStatus DaemonStatus
    DeploymentArn string
    Id string
    The provider-assigned unique ID for this managed resource.
    UpdatedAt string
    created_at string
    daemon_arn string
    daemon_status "ACTIVE" | "DELETE_IN_PROGRESS"
    deployment_arn string
    id string
    The provider-assigned unique ID for this managed resource.
    updated_at string
    createdAt String
    daemonArn String
    daemonStatus DaemonStatus
    deploymentArn String
    id String
    The provider-assigned unique ID for this managed resource.
    updatedAt String
    createdAt string
    daemonArn string
    daemonStatus DaemonStatus
    deploymentArn string
    id string
    The provider-assigned unique ID for this managed resource.
    updatedAt string
    created_at str
    daemon_arn str
    daemon_status DaemonStatus
    deployment_arn str
    id str
    The provider-assigned unique ID for this managed resource.
    updated_at str
    createdAt String
    daemonArn String
    daemonStatus "ACTIVE" | "DELETE_IN_PROGRESS"
    deploymentArn String
    id String
    The provider-assigned unique ID for this managed resource.
    updatedAt String

    Look up Existing Daemon Resource

    Get an existing Daemon 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>, opts?: CustomResourceOptions): Daemon
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None) -> Daemon
    func GetDaemon(ctx *Context, name string, id IDInput, state *DaemonState, opts ...ResourceOption) (*Daemon, error)
    public static Daemon Get(string name, Input<string> id, CustomResourceOptions? opts = null)
    public static Daemon get(String name, Output<String> id, CustomResourceOptions options)
    resources:  existingDaemon:    type: aws-native:ecs:Daemon    get:      id: ${id}
    import {
      to = aws-native_ecs_daemon.example
      id = "${id}"
    }
    
    name string
    The unique name of the resulting resource.
    id Input<ID>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resulting resource.
    id str
    The unique provider ID of the resource to look up.
    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 resulting resource.
    id IDInput
    The unique provider ID of the resource to look up.
    state DaemonState
    Pass nil. This resource has no state arguments.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resulting resource.
    id Input<string>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resulting resource.
    id Output<String>
    The unique provider ID of the resource to look up.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Supporting Types

    DaemonAlarmConfiguration, DaemonAlarmConfigurationArgs

    The CloudWatch alarm configuration for a daemon. When enabled, CloudWatch alarms determine whether a daemon deployment has failed.

    AlarmNames List<string>
    The CloudWatch alarm names to monitor during a daemon deployment.
    Enable bool
    Determines whether to use the CloudWatch alarm option in the daemon deployment process. The default value is false.
    AlarmNames []string
    The CloudWatch alarm names to monitor during a daemon deployment.
    Enable bool
    Determines whether to use the CloudWatch alarm option in the daemon deployment process. The default value is false.
    alarm_names list(string)
    The CloudWatch alarm names to monitor during a daemon deployment.
    enable bool
    Determines whether to use the CloudWatch alarm option in the daemon deployment process. The default value is false.
    alarmNames List<String>
    The CloudWatch alarm names to monitor during a daemon deployment.
    enable Boolean
    Determines whether to use the CloudWatch alarm option in the daemon deployment process. The default value is false.
    alarmNames string[]
    The CloudWatch alarm names to monitor during a daemon deployment.
    enable boolean
    Determines whether to use the CloudWatch alarm option in the daemon deployment process. The default value is false.
    alarm_names Sequence[str]
    The CloudWatch alarm names to monitor during a daemon deployment.
    enable bool
    Determines whether to use the CloudWatch alarm option in the daemon deployment process. The default value is false.
    alarmNames List<String>
    The CloudWatch alarm names to monitor during a daemon deployment.
    enable Boolean
    Determines whether to use the CloudWatch alarm option in the daemon deployment process. The default value is false.

    DaemonDeploymentConfiguration, DaemonDeploymentConfigurationArgs

    Optional deployment parameters that control how a daemon rolls out updates across container instances.

    Alarms Pulumi.AwsNative.Ecs.Inputs.DaemonAlarmConfiguration
    The CloudWatch alarm configuration for the daemon deployment. When alarms are triggered during a deployment, the deployment can be automatically rolled back.
    BakeTimeInMinutes int
    The amount of time (in minutes) to wait after a successful deployment step before proceeding. This allows time to monitor for issues before continuing. The default value is 0.
    DrainPercent double
    The percentage of container instances to drain simultaneously during a daemon deployment. Valid values are between 0.0 and 100.0.
    Alarms DaemonAlarmConfiguration
    The CloudWatch alarm configuration for the daemon deployment. When alarms are triggered during a deployment, the deployment can be automatically rolled back.
    BakeTimeInMinutes int
    The amount of time (in minutes) to wait after a successful deployment step before proceeding. This allows time to monitor for issues before continuing. The default value is 0.
    DrainPercent float64
    The percentage of container instances to drain simultaneously during a daemon deployment. Valid values are between 0.0 and 100.0.
    alarms object
    The CloudWatch alarm configuration for the daemon deployment. When alarms are triggered during a deployment, the deployment can be automatically rolled back.
    bake_time_in_minutes number
    The amount of time (in minutes) to wait after a successful deployment step before proceeding. This allows time to monitor for issues before continuing. The default value is 0.
    drain_percent number
    The percentage of container instances to drain simultaneously during a daemon deployment. Valid values are between 0.0 and 100.0.
    alarms DaemonAlarmConfiguration
    The CloudWatch alarm configuration for the daemon deployment. When alarms are triggered during a deployment, the deployment can be automatically rolled back.
    bakeTimeInMinutes Integer
    The amount of time (in minutes) to wait after a successful deployment step before proceeding. This allows time to monitor for issues before continuing. The default value is 0.
    drainPercent Double
    The percentage of container instances to drain simultaneously during a daemon deployment. Valid values are between 0.0 and 100.0.
    alarms DaemonAlarmConfiguration
    The CloudWatch alarm configuration for the daemon deployment. When alarms are triggered during a deployment, the deployment can be automatically rolled back.
    bakeTimeInMinutes number
    The amount of time (in minutes) to wait after a successful deployment step before proceeding. This allows time to monitor for issues before continuing. The default value is 0.
    drainPercent number
    The percentage of container instances to drain simultaneously during a daemon deployment. Valid values are between 0.0 and 100.0.
    alarms DaemonAlarmConfiguration
    The CloudWatch alarm configuration for the daemon deployment. When alarms are triggered during a deployment, the deployment can be automatically rolled back.
    bake_time_in_minutes int
    The amount of time (in minutes) to wait after a successful deployment step before proceeding. This allows time to monitor for issues before continuing. The default value is 0.
    drain_percent float
    The percentage of container instances to drain simultaneously during a daemon deployment. Valid values are between 0.0 and 100.0.
    alarms Property Map
    The CloudWatch alarm configuration for the daemon deployment. When alarms are triggered during a deployment, the deployment can be automatically rolled back.
    bakeTimeInMinutes Number
    The amount of time (in minutes) to wait after a successful deployment step before proceeding. This allows time to monitor for issues before continuing. The default value is 0.
    drainPercent Number
    The percentage of container instances to drain simultaneously during a daemon deployment. Valid values are between 0.0 and 100.0.

    DaemonPropagateTags

    Specifies whether tags are propagated from the daemon to the daemon tasks.

    NameValue
    DaemonDAEMON
    NoneNONE
    NameValue
    DaemonPropagateTagsDaemonDAEMON
    DaemonPropagateTagsNoneNONE
    Value
    DAEMON
    NONE
    NameValue
    DaemonDAEMON
    NoneNONE
    NameValue
    DaemonDAEMON
    NoneNONE
    NameValue
    DAEMONDAEMON
    NONENONE
    Value
    DAEMON
    NONE

    DaemonStatus

    NameValue
    ActiveACTIVE
    DeleteInProgressDELETE_IN_PROGRESS
    NameValue
    DaemonStatusActiveACTIVE
    DaemonStatusDeleteInProgressDELETE_IN_PROGRESS
    Value
    ACTIVE
    DELETE_IN_PROGRESS
    NameValue
    ActiveACTIVE
    DeleteInProgressDELETE_IN_PROGRESS
    NameValue
    ActiveACTIVE
    DeleteInProgressDELETE_IN_PROGRESS
    NameValue
    ACTIVEACTIVE
    DELETE_IN_PROGRESSDELETE_IN_PROGRESS
    Value
    ACTIVE
    DELETE_IN_PROGRESS

    Tag, TagArgs

    A set of tags to apply to the resource.

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo AWS Cloud Control

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.86.0
    published on Wednesday, Nov 18, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial