Menu
Amazon EC2 Container Service
Developer Guide (API Version 2014-11-13)

API failures Error Messages

In some cases, an API call that you have triggered through the Amazon ECS console or the AWS CLI exits with a failures error message. The following possible API failures error messages are explained below for each API call. The failures occur on a particular resource, and the resource in parentheses is the resource associated with the failure.

Many resources are region-specific, so make sure the console is set to the correct region for your resources, or that your AWS CLI commands are being sent to the correct region with the --region region option.

  • DescribeClusters

    MISSING (cluster ID)

    Your cluster was not found. The cluster name may not have been spelled correctly or the wrong region may be specified.

  • DescribeInstances

    MISSING (container instance ID)

    The container instance you are attempting to describe does not exist. Perhaps the wrong cluster or region has been specified, or the container instance ARN or ID is misspelled.

  • DescribeServices

    MISSING (service ID)

    The service you are attempting to describe does not exist. Perhaps the wrong cluster or region has been specified, or the container instance ARN or ID is misspelled.

  • DescribeTasks

    MISSING (task ID)

    The task you are trying to describe does not exist. Perhaps the wrong cluster or region has been specified, or the task ARN or ID is misspelled.

  • RunTask or StartTask

    RESOURCE:* (container instance ID)

    The resource or resources requested by the task are unavailable on the given container instance. If the resource is CPU, memory, ports, or ENIs, you may need to add container instances to your cluster. For RESOURCE:ENI errors, your cluster does not have any available Elastic Network Interface attachment points, which are required for tasks that use the awsvpc network mode. Amazon EC2 instances have a limit to the number of ENIs that can be attached to them, and the primary network interface counts as one. For more information about how many ENIs are supported per instance type, see IP Addresses Per Network Interface Per Instance Type in the Amazon EC2 User Guide for Linux Instances.

    AGENT (container instance ID)

    The container instance that you attempted to launch a task onto has an agent which is currently disconnected. In order to prevent extended wait times for task placement, the request was rejected.

    ATTRIBUTE (container instance ID)

    Your task definition contains a parameter that requires a specific container instance attribute that is not available on your container instances. For example, if your task uses the awsvpc network mode, but there are no instances in your specified subnets with the ecs.capability.task-eni attribute. For more information on which attributes are required for specific task definition parameters and agent configuration variables, see Task Definition Parameters and Amazon ECS Container Agent Configuration.

  • StartTask

    MISSING (container instance ID)

    The container instance you attempted to launch the task onto does not exist. Perhaps the wrong cluster or region has been specified, or the container instance ARN or ID is misspelled.

    INACTIVE (container instance ID)

    The container instance that you attempted to launch a task onto was previously deregistered with Amazon ECS and cannot be used.