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 lo sono Region-specific, quindi quando usi la console assicurati di impostare la 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](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Failure.html) 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. - ** `DescribeClusters` ** - **Motivo dell'errore o dell'interruzione:** `MISSING` - **Causa:** Il cluster specificato non è stato trovato. Verifica l'ortografia del nome del cluster. - ** `DescribeInstances` ** - **Motivo dell'errore o dell'interruzione:** `MISSING` - **Causa:** 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` ** - **Motivo dell'errore o dell'interruzione:** `MISSING` - **Causa:** 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` ** - **Motivo dell'errore o dell'interruzione:** `MISSING` - **Causa:** 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` ** - **Motivo dell'errore o dell'interruzione:** `TaskFailedToStart: RESOURCE:*` / **Causa:** 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 di attività è maggiore della dimensione della CPU sulle istanze Amazon EC2 definite nel gruppo 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 di attività è maggiore della memoria supportata sulle istanze Amazon EC2 definite nel gruppo Auto Scaling mappato al provider di capacità. È necessario verificare la configurazione del provider di capacità. - **Motivo dell'errore o dell'interruzione:** `TaskFailedToStart: AGENT` / **Causa:** 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?](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami) (Come posso risolvere i problemi di un agente Amazon ECS disconnesso). - **Motivo dell'errore o dell'interruzione:** `TaskFailedToStart: MemberOf placement constraint unsatisfied` / **Causa:** Non è presente alcuna istanza di container che soddisfi i vincoli di posizionamento definiti nella definizione di attività. - **Motivo dell'errore o dell'interruzione:** `TaskFailedToStart: ATTRIBUTE` / **Causa:** 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](task_definition_parameters.md) e [Configurazione dell'agente del container Amazon ECS](ecs-agent-config.md). - **Motivo dell'errore o dell'interruzione:** TaskFailedToStart: NO ACTIVE INSTANCES / **Causa:** Non ci sono istanze attive nel provider di capacità. Per informazioni sulla gestione dei gruppi con dimensionamento automatico, consulta [Gruppi con dimensionamento automatico](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) nella Guida per l'utente di Amazon EC2 Auto Scaling. - **Motivo dell'errore o dell'interruzione:** `TaskFailedToStart: EMPTY CAPACITY PROVIDER` / **Causa:** 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 sulla gestione dei gruppi con dimensionamento automatico, consulta [Gruppi con dimensionamento automatico](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) nella Guida per l'utente di Amazon EC2 Auto Scaling. - ** `GetTaskProtection` ** - **Motivo dell'errore o dell'interruzione:** `MISSING` / **Causa:** 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. - **Motivo dell'errore o dell'interruzione:** `TASK_NOT_VALID` / **Causa:** 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` ** - **Motivo dell'errore o dell'interruzione:** `RESOURCE:*` / **Causa:** 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 la sezione relativa agli [indirizzi IP per interfaccia di rete per tipo di istanza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI) nella *Guida per l'utente di Amazon EC2*.
In caso di `RESOURCE:GPU` errori, il numero di GPU richieste dall'attività non è disponibile e potrebbe essere necessario aggiungere istanze di GPU-enabled container al cluster. Per ulteriori informazioni, consulta [Definizioni di attività Amazon ECS per carichi di lavoro GPU](ecs-gpu.md). - **Motivo dell'errore o dell'interruzione:** `AGENT` / **Causa:** 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?](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami) (Come posso risolvere i problemi di un agente Amazon ECS disconnesso). - **Motivo dell'errore o dell'interruzione:** `LOCATION` / **Causa:** 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`. - **Motivo dell'errore o dell'interruzione:** `ATTRIBUTE` / **Causa:** 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](task_definition_parameters.md) e [Configurazione dell'agente del container Amazon ECS](ecs-agent-config.md). - ** `StartTask` ** - **Motivo dell'errore o dell'interruzione:** `MISSING` / **Causa:** 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. - **Motivo dell'errore o dell'interruzione:** `INACTIVE` / **Causa:** 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` ** - **Motivo dell'errore o dell'interruzione:** `ECS deployment failed` - **Causa:** L'API StopServiceDeployment era gestita da un account fraudolento. - ** `TagResource` ** - **Motivo dell'errore o dell'interruzione:** `InvalidParameterException` - **Causa:** 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 [Eseguire la migrazione di un ARN di servizio breve di Amazon ECS in un ARN lungo](service-arn-migration.md). - ** `UpdateTaskProtection` ** - **Motivo dell'errore o dell'interruzione:** `DEPLOYMENT_BLOCKED` / **Causa:** 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. - **Motivo dell'errore o dell'interruzione:** `MISSING` / **Causa:** 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. - **Motivo dell'errore o dell'interruzione:** `TASK_NOT_VALID` / **Causa:** 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](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/CommonErrors.html).