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 or memory, you may need to add container instances to your cluster.

    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 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.