Updates the Amazon ECS container agent on a specified container instance. Updating the Amazon ECS container agent does not interrupt running tasks or services on the container instance. The process for updating the agent differs depending on whether your container instance was launched with the Amazon ECS-optimized AMI or another operating system.
UpdateContainerAgent
requires the Amazon ECS-optimized AMI or Amazon Linux with the ecs-init
service installed and running. For help updating the Amazon ECS container agent on other operating systems, see Manually Updating the Amazon ECS Container Agent in the Amazon EC2 Container Service Developer Guide.
/// These errors are usually caused by a client action, such as using an action or resource
/// on behalf of a user that doesn't have permission to use the action or resource, or
/// specifying an identifier that is not valid.
///
/// The specified cluster could not be found. You can view your available clusters with
///
ListClusters. Amazon ECS clusters are region-specific.
///
/// The specified parameter is invalid. Review the available parameters for the API request.
///
/// Amazon ECS is unable to determine the current version of the Amazon ECS container
/// agent on the container instance and does not have enough information to proceed with
/// an update. This could be because the agent running on the container instance is an
/// older or custom version that does not use our version information.
///
/// There is no update available for this Amazon ECS container agent. This could be because
/// the agent is already running the latest version, or it is so old that there is no
/// update path to the current version.
///
/// These errors are usually caused by a server issue.
///
/// There is already a current Amazon ECS container agent update in progress on the specified
/// container instance. If the container agent becomes disconnected while it is in a transitional
/// stage, such as
PENDING
or
STAGING
, the update process can
/// get stuck in that state. However, when the agent reconnects, it resumes where it stopped
/// previously.
///