Motivi degli errori dell'API

Quando un'azione API che hai attivato tramite l'API, la console o la console di Amazon ECS AWS CLI esce con un messaggio di failures errore, quanto segue può aiutarti a risolvere la causa. L'errore restituisce un motivo e l'Amazon Resource Name (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 usi il AWS CLI, assicurati che i AWS CLI 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 alcuni esempi di messaggi di errore che potreste ricevere durante l'esecuzione di 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:*	Per gli errori RESOURCE:CPU indica che il numero di CPU richiesto dall'attività non è disponibile sulle istanze di container. Ciò si verifica in genere quando il requisito dell'unità CPU nella definizione dell'attività è maggiore della dimensione della CPU delle istanze Amazon EC2 definite nel gruppo Auto Scaling mappato al provider di capacità. È necessario verificare la configurazione del provider di capacità. Per informazioni su come aggiungere, visualizzare e modificare i provider di capacità, consulta Provider di capacità Amazon ECS. 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 sulle istanze Amazon EC2 definita nel gruppo Auto Scaling mappato al provider di capacità. È necessario verificare la configurazione del provider di capacità. Per informazioni su come aggiungere, visualizzare e modificare i provider di capacità, consulta Provider di capacità Amazon ECS.
	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 esiste un'istanza di contenitore che soddisfi i vincoli di posizionamento definiti nella definizione dell'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à 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 aggiungere, visualizzare e modificare i provider di capacità, consulta Provider di capacità Amazon ECS. Per informazioni sulla gestione dei gruppi con dimensionamento automatico, consulta Gruppi con dimensionamento automatico nella Guida per l'utente di Dimensionamento automatico Amazon EC2.
	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 provider di capacità, consulta Provider di capacità Amazon ECS. Per informazioni sulla gestione dei gruppi con dimensionamento automatico, consulta Gruppi con dimensionamento automatico nella Guida per l'utente di Dimensionamento automatico Amazon EC2.
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. Il numero di interfacce di rete che possono essere collegate alle istanze Amazon EC2 è limitato e l'interfaccia di rete primaria conta come una di queste. Per ulteriori informazioni sul numero di interfacce di rete supportate per ogni interfaccia di rete, consulta Indirizzi IP per interfaccia di rete e per tipo di istanza nella Guida per l'utente di Amazon EC2 per le istanze Linux. Per errori RESOURCE:GPU, il numero di GPU richieste dal processo non è disponibile e potrebbe essere necessario aggiungere istanze di container abilitate per GPU al cluster. Per ulteriori informazioni, consulta Utilizzo di GPU su Amazon ECS.
	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à e Configurazione dell'agente del container Amazon ECS.
StartTask	MISSING	L'istanza del contenitore su cui hai tentato di avviare l'attività non è stata trovata. Controlla se è stato specificato il cluster o la regione errati o se l'ARN o l'ID dell'istanza del contenitore è stato digitato in modo 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.
UpdateTaskProtection	DEPLOYMENT_BLOCKED	Impossibile impostare la protezione delle attività poiché una o più attività protette impediscono alla distribuzione 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 descritti qui, le operazioni API possono fallire anche a causa di eccezioni, con conseguenti risposte di errore. Per un elenco di tali eccezioni, consulta Errori comuni.