Motivos de error de la API de Amazon ECS - Amazon Elastic Container Service

Motivos de error de la API de Amazon ECS

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

Acción de la API Motivo del error o motivo de la detención Causa

DescribeClusters

MISSING

No se encontró el clúster especificado. Compruebe la ortografía del nombre del clúster.

DescribeInstances

MISSING

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

MISSING

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

MISSING

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

TaskFailedToStart: RESOURCE:*

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.

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.

TaskFailedToStart: AGENT

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.

Para obtener información acerca de cómo solucionar problemas de un agente desconectado, consulte How do I troubleshoot a disconnected Amazon ECS agent (¿Cómo soluciono problemas de un agente de Amazon ECS desconectado?).

TaskFailedToStart: MemberOf placement constraint unsatisfied

No hay ninguna instancia de contenedor que cumpla con las restricciones de ubicación definidas en la definición de la tarea.

TaskFailedToStart: ATTRIBUTE

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 de definición de tareas de Amazon ECS y Configuración del agente de contenedor de Amazon ECS.

TaskFailedToStart: NO ACTIVE INSTANCES 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 en la Guía del usuario de Amazon EC2 Auto Scaling.

TaskFailedToStart: EMPTY CAPACITY PROVIDER

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 en la Guía del usuario de Amazon EC2 Auto Scaling.

GetTaskProtection

MISSING

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.

TASK_NOT_VALID

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

RESOURCE:*

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.

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 en la Guía del usuario de Amazon EC2.

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.

AGENT

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.

Para obtener información acerca de cómo solucionar problemas de un agente desconectado, consulte How do I troubleshoot a disconnected Amazon ECS agent (¿Cómo soluciono problemas de un agente de Amazon ECS desconectado?).

LOCATION

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.

ATTRIBUTE

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 de definición de tareas de Amazon ECS y Configuración del agente de contenedor de Amazon ECS.

StartTask

MISSING

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.

INACTIVE

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.

UpdateTaskProtection

DEPLOYMENT_BLOCKED

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.

MISSING

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.

TASK_NOT_VALID

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 (Errores comunes).