# Motivos de error de la API de Amazon ECS
<a name="api_failures_messages"></a>

Cuando una acción de API que haya desencadenado a través de la API de Amazon ECS, la consola o la AWS CLI genera un mensaje de error `failures`, puede seguir estos pasos para ayudar a solucionar la causa. El error devuelve un motivo y el nombre de recurso de Amazon (ARN) del recurso asociado al error.

Muchos recursos son específicos de la región, por lo que debe asegurarse de configurar la región correcta para los recursos cuando utilice la consola. Cuando utilice la AWS CLI, asegúrese de que los comandos de la AWS CLI se envíen a la región correcta mediante el parámetro `--region {{region}}`.

Para obtener más información acerca de la estructura del tipo de datos `Failure`, consulte [Error](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Failure.html) en la *Referencia de la API de Amazon Elastic Container Service*.

A continuación, se muestran ejemplos de mensajes de error que puede recibir al ejecutar comandos de la API. 



- ** `DescribeClusters` **
  - **Motivo del error o motivo de la detención:** `MISSING`
  - **Causa:** No se encontró el clúster especificado. Compruebe la ortografía del nombre del clúster.

- ** `DescribeInstances` **
  - **Motivo del error o motivo de la detención:** `MISSING`
  - **Causa:** No se encontró la instancia de contenedor especificada. Compruebe que se haya especificado el clúster en el que está registrada la instancia de contenedor y que tanto el ARN como el ID de la instancia del contenedor sean correctos.

- ** `DescribeServices` **
  - **Motivo del error o motivo de la detención:** `MISSING`
  - **Causa:** No se encontró el servicio especificado. Compruebe que se haya especificado el clúster o la región correctos y que el ARN o el nombre del servicio sean válidos.

- ** `DescribeTasks` **
  - **Motivo del error o motivo de la detención:** `MISSING`
  - **Causa:** No se encontró la tarea especificada. Compruebe que se haya especificado el clúster o la región correctos y que tanto el ID como el ARN de la tarea sean válidos.

- ** `DescribeTasks`  **
  - **Motivo del error o motivo de la detención:** `TaskFailedToStart: RESOURCE:*` / **Causa:** En el caso de los errores de `RESOURCE:CPU`, la cantidad de CPU solicitadas por la tarea no está disponible en la instancia de contenedor. Esto suele ocurrir cuando el requisito de unidades de CPU en la definición de la tarea es mayor que el tamaño de la CPU de las instancias de Amazon EC2 definidas en el grupo de escalado automático asignado al proveedor de capacidad. Debe comprobar la configuración del proveedor de capacidad.<br />En el caso de los errores de `RESOURCE:MEMORY`, la cantidad de memoria solicitada por la tarea no está disponible en la instancia de contenedor. Esto suele ocurrir cuando el requisito de cantidad de memoria en la definición de la tarea es mayor que la memoria admitida en las instancias de Amazon EC2 definidas en el grupo de escalado automático asignado al proveedor de capacidad. Debe comprobar la configuración del proveedor de capacidad.
  - **Motivo del error o motivo de la detención:** `TaskFailedToStart: AGENT` / **Causa:** La instancia de contenedor en la que se ha intentado lanzar una tarea tiene un agente que está desconectado actualmente. Para evitar tiempos de espera prolongados para la ubicación de tareas, se rechazó la solicitud.<br />Para obtener información acerca de cómo solucionar problemas de un agente desconectado, consulte [How do I troubleshoot a disconnected Amazon ECS agent](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami) (¿Cómo soluciono problemas de un agente de Amazon ECS desconectado?).
  - **Motivo del error o motivo de la detención:** `TaskFailedToStart: MemberOf placement constraint unsatisfied` / **Causa:** No hay ninguna instancia de contenedor que cumpla con las restricciones de ubicación definidas en la definición de la tarea.
  - **Motivo del error o motivo de la detención:** `TaskFailedToStart: ATTRIBUTE` / **Causa:** La definición de tareas contiene un parámetro que requiere un atributo de instancia de contenedor específico que no está disponible en las instancias de contenedor. Por ejemplo, si su tarea usa el modo de red `awsvpc`, pero no hay ninguna instancia en sus subredes especificadas con el atributo `ecs.capability.task-eni`. Para obtener más información sobre qué atributos son necesarios para determinados parámetros de definición de tareas y variables de configuración del agente, consulte [Parámetros en la definición de tareas de Amazon ECS para Fargate](task_definition_parameters.md) y [Configuración del agente de contenedor de Amazon ECS](ecs-agent-config.md).
  - **Motivo del error o motivo de la detención:** TaskFailedToStart: NO ACTIVE INSTANCES / **Causa:** No hay instancias activas en su proveedor de capacidad. Para obtener información sobre cómo administrar grupos de escalado automático, consulte [Grupos de escalado automático](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) en la Guía del usuario de Amazon EC2 Auto Scaling.
  - **Motivo del error o motivo de la detención:** `TaskFailedToStart: EMPTY CAPACITY PROVIDER` / **Causa:** No hay instancias en su clúster. Lo más probable es que se deba a un proveedor de capacidad vacío o a que las instancias del proveedor de capacidad no estén registradas en el clúster. Para obtener información sobre cómo administrar grupos de escalado automático, consulte [Grupos de escalado automático](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) en la Guía del usuario de Amazon EC2 Auto Scaling.

- ** `GetTaskProtection` **
  - **Motivo del error o motivo de la detención:** `MISSING` / **Causa:** No se encontró la tarea especificada. Compruebe que el nombre o ARN del clúster y el ID o ARN de la tarea sean válidos.
  - **Motivo del error o motivo de la detención:** `TASK_NOT_VALID` / **Causa:** La tarea especificada no forma parte de un servicio de Amazon ECS. Solo se pueden proteger las tareas administradas por servicios de Amazon ECS. Compruebe el ARN o ID de la tarea e inténtelo de nuevo.

- ** `RunTask` o `StartTask` **
  - **Motivo del error o motivo de la detención:** `RESOURCE:*` / **Causa:** Los recursos solicitados por la tarea no están disponibles en la instancia de contenedor del clúster. Si el recurso es CPU, memoria, puertos o interfaces de red elásticas, es posible que tenga que agregar instancias de contenedor al clúster.<br />En el caso de errores `RESOURCE:ENI`, el clúster no tiene ningún punto de asociación disponible a la interfaz de red elástica. Las tareas que utilizan el modo de red `awsvpc` necesitan estos puntos de asociación. Las instancias de Amazon EC2 presentan un límite en cuanto al número de interfaces de red que pueden tener asociadas, y la interfaz de red principal cuenta como una. Para obtener más información acerca de cuántas interfaces de red se admiten para cada tipo de instancias, consulte [Direcciones IP por interfaz de red por tipo de instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI) en la *Guía del usuario de Amazon EC2*.<br />En el caso de errores `RESOURCE:GPU`, el número de GPU solicitadas por la tarea no está disponible y es posible que tenga que agregar instancias de contenedor habilitadas para GPU al clúster. Para obtener más información, consulte [Definiciones de tareas de Amazon ECS para cargas de trabajo de GPU](ecs-gpu.md).
  - **Motivo del error o motivo de la detención:** `AGENT` / **Causa:** La instancia de contenedor en la que se ha intentado lanzar una tarea tiene un agente que está desconectado actualmente. Para evitar tiempos de espera prolongados para la ubicación de tareas, se rechazó la solicitud.<br />Para obtener información acerca de cómo solucionar problemas de un agente desconectado, consulte [How do I troubleshoot a disconnected Amazon ECS agent](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami) (¿Cómo soluciono problemas de un agente de Amazon ECS desconectado?).
  - **Motivo del error o motivo de la detención:** `LOCATION` / **Causa:** La instancia de contenedor en la que intentó lanzar una tarea se encuentra en una zona de disponibilidad distinta a la de las subredes especificadas en la `awsVpcConfiguration`.
  - **Motivo del error o motivo de la detención:** `ATTRIBUTE` / **Causa:** La definición de tareas contiene un parámetro que requiere un atributo de instancia de contenedor específico que no está disponible en las instancias de contenedor. Por ejemplo, si su tarea usa el modo de red `awsvpc`, pero no hay ninguna instancia en sus subredes especificadas con el atributo `ecs.capability.task-eni`. Para obtener más información sobre qué atributos son necesarios para determinados parámetros de definición de tareas y variables de configuración del agente, consulte [Parámetros en la definición de tareas de Amazon ECS para Fargate](task_definition_parameters.md) y [Configuración del agente de contenedor de Amazon ECS](ecs-agent-config.md).

- ** `StartTask` **
  - **Motivo del error o motivo de la detención:** `MISSING` / **Causa:** No se encuentra la instancia de contenedor en la que ha intentado lanzar la tarea. Compruebe si se ha especificado un clúster o una región incorrectos o si el ID o el ARN de la instancia de contenedor estén mal escritos.
  - **Motivo del error o motivo de la detención:** `INACTIVE` / **Causa:** Anteriormente se anuló el registro en Amazon ECS de la instancia de contenedor en la que ha intentado lanzar una tarea, y no se puede utilizar.

- ** `StopServiceDeployment` **
  - **Motivo del error o motivo de la detención:** `ECS deployment failed`
  - **Causa:** Una cuenta fraudulenta ejecutó la API StopServiceDeployment.

- ** `TagResource` **
  - **Motivo del error o motivo de la detención:** `InvalidParameterException`
  - **Causa:** El ARN del servicio que está etiquetando tiene el formato corto. Debe migrar al formato largo. Para obtener información acerca de migrar el ARN, consulte [Migración de un ARN de servicio corto de Amazon ECS a un ARN largo](service-arn-migration.md).

- ** `UpdateTaskProtection` **
  - **Motivo del error o motivo de la detención:** `DEPLOYMENT_BLOCKED` / **Causa:** No se puede configurar la protección de tareas, ya que una o más tareas protegidas impiden que la implementación del servicio alcance un estado estable. Desactive la protección en las tareas existentes o espere hasta que esta caduque.
  - **Motivo del error o motivo de la detención:** `MISSING` / **Causa:** No se encontró la tarea especificada. Compruebe que el nombre o ARN del clúster y el ID o ARN de la tarea sean válidos.
  - **Motivo del error o motivo de la detención:** `TASK_NOT_VALID` / **Causa:** La tarea especificada no forma parte de un servicio de Amazon ECS. Solo se pueden proteger las tareas administradas por servicios de Amazon ECS. Compruebe el ARN o ID de la tarea e inténtelo de nuevo.



**nota**  
Además de las situaciones de error descritas aquí, las operaciones de las API también pueden fallar debido a excepciones, lo que genera respuestas de error. Para obtener una lista de estas excepciones, consulte [Common Errors](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/CommonErrors.html) (Errores comunes).