Motivi degli errori dell'API Amazon ECS - Amazon Elastic Container Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Motivi degli errori dell'API Amazon ECS

Quando un'azione API che hai attivato tramite l'API Amazon ECS, la console o AWS CLI esce con un messaggio di errore failures, quanto segue potrebbe essere utile nella risoluzione dei problemi della causa. L'errore restituisce un motivo e il nome della risorsa Amazon (ARN) della risorsa associata all'errore.

Molte risorse sono specifiche della regione, quindi accertati che la console sia impostata sulla regione corretta per le tue risorse. Quando utilizzate il AWS CLI, assicuratevi che AWS CLI i comandi vengano inviati alla regione corretta con il --region region parametro.

Per ulteriori informazioni sulla struttura del tipo di dati Failure, consulta Errore nella Documentazione di riferimento dell'API di Amazon Elastic Container Service.

Di seguito sono riportati esempi di messaggi di errore che potresti ricevere durante l'esecuzione dei comandi API.

Azione API Motivo dell'errore o dell'interruzione Causa

DescribeClusters

MISSING

Il cluster specificato non è stato trovato. Verifica l'ortografia del nome del cluster.

DescribeInstances

MISSING

L'istanza del container specificata non è stata trovata. Verifica che sia stato specificato il cluster in cui è registrata l'istanza di container e che l'ARN o l'ID dell'istanza di container sia corretto.

DescribeServices

MISSING

Il servizio specificato non è stato trovato. Verifica che sia specificato il cluster o la regione corretta e che l'ARN del servizio o il nome sia valido.

DescribeTasks

MISSING

Il processo specificato non è stato trovato. Verifica che sia specificato il cluster o la regione corretta e che l'ARN del processo o il nome sia valido.

DescribeTasks

TaskFailedToStart: RESOURCE:*

In caso di RESOURCE:CPU errori, il numero di CPUs richieste dall'attività non è disponibile nelle istanze del contenitore. Ciò si verifica in genere quando il requisito dell'unità CPU nella definizione dell'attività è maggiore della dimensione della CPU delle EC2 istanze Amazon definite nel gruppo Amazon EC2 Auto Scaling mappato al provider di capacità. È necessario verificare la configurazione del provider di capacità.

Per gli errori RESOURCE:MEMORY indica che la quantità di memoria richiesta dall'attività non è disponibile sulle istanze di container. Ciò si verifica in genere quando la quantità di memoria richiesta nella definizione dell'attività è maggiore della memoria supportata nelle EC2 istanze Amazon definite nel gruppo Amazon EC2 Auto Scaling mappato al provider di capacità. È necessario verificare la configurazione del provider di capacità.

TaskFailedToStart: AGENT

L'istanza di container su cui hai provato ad avviare un processo ha un agente attualmente disconnesso. Per prevenire lunghi tempi di attesa per il posizionamento delle attività, la richiesta è stata respinta.

Per informazioni su come risolvere i problemi relativi a un agente disconnesso, consulta How do I troubleshoot a disconnected Amazon ECS agent? (Come posso risolvere i problemi di un agente Amazon ECS disconnesso).

TaskFailedToStart: MemberOf placement constraint unsatisfied

Non è presente alcuna istanza di container che soddisfi i vincoli di posizionamento definiti nella definizione di attività.

TaskFailedToStart: ATTRIBUTE

La tua definizione di attività contiene un parametro che richiede un determinato attributo dell'istanza di container che non è disponibile nelle tue istanze di container. Ad esempio, se la tua attività utilizza la modalità di rete awsvpc, ma non sono presenti istanze nelle sottoreti da te specificate con l'attributo ecs.capability.task-eni. Per ulteriori informazioni sugli attributi richiesti per determinati parametri di definizione di attività e variabili di configurazione dell'agente, consulta Parametri di definizione di attività Amazon ECS per Fargate e Configurazione dell'agente del container Amazon ECS.

TaskFailedToStart: NO ACTIVE INSTANCES Non ci sono istanze attive nel provider di capacità. Per informazioni su come gestire i gruppi Amazon EC2 Auto Scaling, consulta i gruppi Amazon Auto EC2 Scaling nella Amazon Auto Scaling User EC2 Guide.

TaskFailedToStart: EMPTY CAPACITY PROVIDER

Nel cluster non sono presenti istanze. Ciò è probabilmente dovuto a un provider di capacità vuoto o al fatto che le istanze del provider di capacità non sono registrate nel cluster. Per informazioni su come gestire i gruppi Amazon EC2 Auto Scaling, consulta i gruppi Amazon Auto EC2 Scaling nella Amazon Auto Scaling User EC2 Guide.

GetTaskProtection

MISSING

Il processo specificato non è stato trovato. Verifica che il nome o l'ARN del cluster e l'ARN o l'ID dell'attività siano validi.

TASK_NOT_VALID

L'attività specificata non fa parte di un servizio Amazon ECS. Solo le attività gestite dai servizi Amazon ECS possono essere protette. Verifica l'ARN o l'ID dell'attività e riprova.

RunTask o StartTask

RESOURCE:*

La risorsa o le risorse richieste dal processo non sono disponibili sull'istanza di container nel cluster. Se la risorsa corrisponde a CPU, memoria, porte o interfacce di rete elastiche, potrebbe essere necessario aggiungere istanze di container al tuo cluster.

Per gli errori RESOURCE:ENI, il tuo cluster non dispone di punti di collegamento per l'interfaccia di rete elastica che sono necessari per i processi che utilizzano la modalità di rete awsvpc. EC2 Le istanze Amazon hanno un limite al numero di interfacce di rete che possono essere collegate a esse e l'interfaccia di rete principale conta come una. Per ulteriori informazioni su quante interfacce di rete sono supportate per ogni tipo di istanza, consulta Indirizzi IP per interfaccia di rete per tipo di istanza nella Amazon EC2 User Guide.

In caso di RESOURCE:GPU errori, il numero di GPUs richieste dall'attività non è disponibile e potrebbe essere necessario aggiungere istanze di container abilitate per GPU al cluster. Per ulteriori informazioni, consulta Definizioni di attività Amazon ECS per carichi di lavoro GPU.

AGENT

L'istanza di container su cui hai provato ad avviare un processo ha un agente attualmente disconnesso. Per prevenire lunghi tempi di attesa per il posizionamento delle attività, la richiesta è stata respinta.

Per informazioni su come risolvere i problemi relativi a un agente disconnesso, consulta How do I troubleshoot a disconnected Amazon ECS agent? (Come posso risolvere i problemi di un agente Amazon ECS disconnesso).

LOCATION

L'istanza di container su cui hai provato ad avviare un processo si trova in una zona di disponibilità diversa rispetto alle sottoreti specificate in awsVpcConfiguration.

ATTRIBUTE

La tua definizione di attività contiene un parametro che richiede un determinato attributo dell'istanza di container che non è disponibile nelle tue istanze di container. Ad esempio, se la tua attività utilizza la modalità di rete awsvpc, ma non sono presenti istanze nelle sottoreti da te specificate con l'attributo ecs.capability.task-eni. Per ulteriori informazioni sugli attributi richiesti per determinati parametri di definizione di attività e variabili di configurazione dell'agente, consulta Parametri di definizione di attività Amazon ECS per Fargate e Configurazione dell'agente del container Amazon ECS.

StartTask

MISSING

L'istanza di container su cui hai provato ad avviare l'attività non è stata trovata. Verifica che non siano stati specificati il cluster o la regione corretti oppure che l'ID o l'ARN dell'istanza di container non sia errato.

INACTIVE

La registrazione dell'istanza di container su cui hai provato ad avviare un processo è stata precedentemente revocata con Amazon ECS quindi non può essere utilizzata.

StopServiceDeployment

ECS deployment failed

L'API StopServiceDeployment era gestita da un account fraudolento.

TagResource

InvalidParameterException

L'ARN per il servizio su cui stai applicando il tag ha il formato breve. È necessaria la migrazione al formato lungo. Per informazioni sulla migrazione dell'ARN, consulta Esegui la migrazione di un ARN di servizio breve di Amazon ECS a un ARN lungo.

UpdateTaskProtection

DEPLOYMENT_BLOCKED

Non è possibile impostare la protezione delle attività poiché una o più attività protette impediscono all'implementazione del servizio di raggiungere uno stato stazionario. Annulla l'impostazione della protezione delle attività sulle attività esistenti o attendi la scadenza della protezione.

MISSING

Il processo specificato non è stato trovato. Verifica che il nome o l'ARN del cluster e l'ARN o l'ID dell'attività siano validi.

TASK_NOT_VALID

L'attività specificata non fa parte di un servizio Amazon ECS. Solo le attività gestite dai servizi Amazon ECS possono essere protette. Verifica l'ARN o l'ID dell'attività e riprova.

Nota

Oltre agli scenari di errore qui descritti, le operazioni API possono non riuscire anche a causa di eccezioni, con conseguenti risposte di errore. Per un elenco di tali eccezioni, consulta Errori comuni.