Update Daemon

ecs_update_daemon

R Documentation

Updates the specified daemon¶

Description¶

Updates the specified daemon. When you update a daemon, a new deployment is triggered that progressively rolls out the changes to the container instances associated with the daemon's capacity providers. For more information, see Daemon deployments in the Amazon Elastic Container Service Developer Guide.

Amazon ECS drains existing container instances and provisions new instances with the updated daemon. Amazon ECS automatically launches replacement tasks for your services.

Updating a daemon triggers a rolling deployment that drains and replaces container instances. Plan updates during maintenance windows to minimize impact on running services.

ECS Managed Daemons is only supported for Amazon ECS Managed Instances Capacity Providers.

Usage¶

ecs_update_daemon(daemonArn, daemonTaskDefinitionArn,
  capacityProviderArns, deploymentConfiguration, propagateTags,
  enableECSManagedTags, enableExecuteCommand)

Arguments¶

daemonArn

[required] The Amazon Resource Name (ARN) of the daemon to update.

daemonTaskDefinitionArn

[required] The Amazon Resource Name (ARN) of the daemon task definition to use for the updated daemon.

capacityProviderArns

[required] The Amazon Resource Names (ARNs) of the capacity providers to associate with the daemon.

deploymentConfiguration

Optional deployment parameters that control how the daemon rolls out updates, including the drain percentage, alarm-based rollback, and bake time.

propagateTags

Specifies whether to propagate the tags from the daemon to the daemon tasks. If you don't specify a value, the tags aren't propagated. You can only propagate tags to daemon tasks during task creation.

enableECSManagedTags

Specifies whether to turn on Amazon ECS managed tags for the tasks in the daemon. For more information, see Tagging your Amazon ECS resources in the Amazon Elastic Container Service Developer Guide.

enableExecuteCommand

If true, the execute command functionality is turned on for all tasks in the daemon. If false, the execute command functionality is turned off.

Value¶

A list with the following syntax:

list(
  daemonArn = "string",
  status = "ACTIVE"|"DELETE_IN_PROGRESS",
  createdAt = as.POSIXct(
    "2015-01-01"
  ),
  updatedAt = as.POSIXct(
    "2015-01-01"
  ),
  deploymentArn = "string"
)

Request syntax¶

svc$update_daemon(
  daemonArn = "string",
  daemonTaskDefinitionArn = "string",
  capacityProviderArns = list(
    "string"
  ),
  deploymentConfiguration = list(
    drainPercent = 123.0,
    alarms = list(
      alarmNames = list(
        "string"
      ),
      enable = TRUE|FALSE
    ),
    bakeTimeInMinutes = 123
  ),
  propagateTags = "DAEMON"|"NONE",
  enableECSManagedTags = TRUE|FALSE,
  enableExecuteCommand = TRUE|FALSE
)