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

# Annullamento della registrazione di un'istanza esterna Amazon ECS
<a name="ecs-anywhere-deregistration"></a>

Ti consigliamo di annullare la registrazione dell'istanza sia da Amazon ECS che AWS Systems Manager dopo aver terminato con l'istanza. In seguito all'annullamento della registrazione, l'istanza esterna non è più in grado di accettare nuovi processi.

Se hai processi in esecuzione nell'istanza di container al momento dell'annullamento della registrazione, questi processi continueranno a essere in esecuzione fino all'arresto in altri modi. Tuttavia, questi processi sono orfani (non più monitorati o tenuti in conto da Amazon ECS). Se questi processi sull'istanza esterna fanno parte di un servizio Amazon ECS, allora se possibile il pianificatore di servizi avvia un'altra copia del processo su un'istanza differente.

Dopo aver annullato la registrazione dell'istanza, pulisci le risorse rimanenti AWS sull'istanza. Potrai quindi registrarla in un nuovo cluster.

## Procedura
<a name="ecs-anywhere-deregistration-procedure"></a>

------
#### [ Console di gestione AWS ]

1. Apri la console all'indirizzo. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)

1. Dalla barra di navigazione, scegli la Regione in cui l'istanza esterna è registrata.

1. Nel riquadro di navigazione, scegli **Cluster** e seleziona il cluster che ospita l'istanza esterna.

1. Nella {{name}} pagina **Cluster:**, scegli la scheda **Infrastruttura**.

1. In **Container instances** (Istanze di container), seleziona l'ID dell'istanza esterna per la quale annullare la registrazione. Si sarà reindirizzati alla pagina dei dettagli dell'istanza di container.

1. Nella {{id}} pagina **Container Instance:**, scegli **Annulla registrazione**.

1. Esamina il messaggio di annullamento della registrazione. Seleziona **Annulla registrazione da AWS Systems Manager** per annullare la registrazione dell'istanza esterna come istanza gestita da Systems Manager. Scegli **Annulla registrazione**.
**Nota**  
È possibile annullare la registrazione dell'istanza esterna come istanza gestita da Systems Manager nella console di Systems Manager. Per istruzioni, consulta [Annullare la registrazione di nodi gestiti in ambienti ibridi e multicloud](https://docs.aws.amazon.com/systems-manager/latest/userguide/fleet-manager-deregister-hybrid-nodes.html) nella *Guida per l'utente di AWS Systems Manager *.

1. Dopo aver annullato la registrazione dell'istanza, pulisci AWS le risorse sul server o sulla macchina virtuale locale.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/AmazonECS/latest/developerguide/ecs-anywhere-deregistration.html)

------
#### [ AWS CLI ]

1. Per annullare la registrazione dell'istanza di container, sono necessari l'ID istanza e l'ARN dell'istanza di container. Se non disponi di questi valori, esegui i comandi seguenti

   Esegui il comando seguente per ottenere l'ID istanza.

   Utilizza l'ID dell'istanza (`instanceID`) per ottenere l'ARN dell'istanza di container (`containerInstanceARN`).

   ```
   instanceId=$(aws ssm describe-instance-information --region "{{ {{region}} }}" | jq ".InstanceInformationList[] |select(.IPAddress==\"{{ IPv4 Address }}\") | .InstanceId" | tr -d'"'
   ```

   Esegui i comandi seguenti.

   Utilizza `containerInstanceArn`come parametro nel comando per annullare la registrazione dell'istanza (`deregister-container-instance`).

   ```
   instances=$(aws ecs list-container-instances --cluster "{{ {{cluster}} }}" --region "{{ {{region}} }}" | jq -c '.containerInstanceArns')
   containerInstanceArn=$(aws ecs describe-container-instances --cluster "{{ {{cluster}} }}" --region "{{ {{region}} }}" --container-instances $instances | jq ".containerInstances[] | select(.ec2InstanceId==\"{{ {{instanceId}} }}\") | .containerInstanceArn" | tr -d '"')
   ```

1.  Esegui il seguente comando per svuotare l'istanza.

   ```
   aws ecs update-container-instances-state --cluster "{{ {{cluster}} }}" --region "{{ {{region}} }}" --container-instances "{{ {{containerInstanceArn}} }}" --status DRAINING
   ```

1. Al termine dell'operazione, esegui il comando seguente per annullare la registrazione dell'istanza.

   ```
   aws ecs deregister-container-instance --cluster "{{ {{cluster}} }}" --region "{{ {{region}} }}" --container-instance "{{ {{containerInstanceArn}} }}"
   ```

1. Esegui il comando seguente per rimuovere l'istanza di container da SSM.

   ```
   aws ssm deregister-managed-instance --region "{{ {{region}} }}" --instance-id "{{ {{instanceId}} }}"
   ```

1. Dopo aver annullato la registrazione dell'istanza, pulisci le AWS risorse sul server o sulla macchina virtuale locale.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/AmazonECS/latest/developerguide/ecs-anywhere-deregistration.html)

------