Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Abmelden einer externen Amazon-ECS-Instance
<a name="ecs-anywhere-deregistration"></a>

Wir empfehlen, dass Sie die Instance sowohl bei Amazon ECS als auch AWS Systems Manager danach abmelden, wenn Sie mit der Instance fertig sind. Nach Aufhebung der Registrierung kann die externe Instance keine neuen Aufgaben mehr akzeptieren.

Wenn zum Zeitpunkt der Abmeldung auf der Container-Instance Aufgaben ausgeführt werden, bleiben diese Aufgaben aktiv, bis die Aufgaben auf andere Weise gestoppt werden. Diese Aufgaben werden jedoch nicht mehr von Amazon ECS überwacht bzw. erfasst. Falls diese Aufgaben auf Ihrer externen Instance Teil eines Amazon-ECS-Service ist, startet der Service-Scheduler eine andere Kopie der betreffenden Aufgabe in einer anderen Instance, sofern dies möglich ist.

Nachdem Sie die Instance deregistriert haben, bereinigen Sie die verbleibenden AWS Ressourcen auf der Instance. Sie können die Instance dann in einem neuen Cluster registrieren.

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

------
#### [ AWS-Managementkonsole ]

1. Öffnen Sie die Konsole unter. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)

1. Wählen Sie auf der Navigationsleiste die Region aus, in der Ihre externe Instance registriert ist.

1. Wählen Sie im Navigationsbereich **Clusters** und danach den Cluster aus, der Ihre externe Instance hostet.

1. Wählen Sie auf der {{name}} Seite **Cluster:** die Registerkarte **Infrastruktur** aus.

1. Wählen Sie unter **Container instances** (Container-Instances) die externe Instance-ID aus, deren Anmeldung aufgehoben werden soll. Sie werden zur Detailseite für Container-Instance umgeleitet.

1. Wählen Sie auf der {{id}} Seite **Container Instance:** die Option **Deregister** aus.

1. Überprüfen Sie die Meldung zum Abmelden. Wählen Sie **Abmelden von AWS Systems Manager** aus, um die externe Instance auch als verwaltete Instance von Systems Manager abzumelden. Wählen Sie **Deregister**.
**Anmerkung**  
Sie können die externe Instance in der Systems Manager Konsole als verwaltete Instance von Systems Manager abmelden. Anweisungen dazu finden Sie im unter [Deregistrierung verwalteter Knoten in einer Hybrid- und Multi-Cloud-Umgebung](https://docs.aws.amazon.com/systems-manager/latest/userguide/fleet-manager-deregister-hybrid-nodes.html) im *Benutzerhandbuch für AWS Systems Manager *.

1. Nachdem Sie die Instance deregistriert haben, bereinigen Sie die AWS Ressourcen auf Ihrem lokalen Server oder Ihrer VM.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/AmazonECS/latest/developerguide/ecs-anywhere-deregistration.html)

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

1. Sie benötigen die Instance-ID und den Container-Instance-ARN, um die Registrierung der Container-Instance aufzuheben. Wenn Sie diese Werte nicht haben, führen Sie die folgenden Befehle aus

   Führen Sie den folgenden Befehl aus, um die Instance-ID zu erhalten.

   Sie verwenden die Instance-ID (`instanceID`), um den Container-Instance ARN (`containerInstanceARN`) abzurufen.

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

   Führen Sie die folgenden Befehle aus.

   Sie verwenden `containerInstanceArn` als Parameter im Befehl, um die Registrierung der Instance (`deregister-container-instance`) aufzuheben.

   ```
   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.  Führen Sie den folgenden Befehl aus, um die Instance zu leeren.

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

1. Nachdem die Container-Instance den Ausgleich abgeschlossen hat, führen Sie den folgenden Befehl aus, um die Registrierung der Instance aufzuheben.

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

1. Führen Sie den folgenden Befehl aus, um die Container-Instance aus SSM zu entfernen.

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

1. Nachdem Sie die Registrierung der Instanz aufgehoben haben, bereinigen Sie die AWS Ressourcen auf Ihrem lokalen Server oder Ihrer VM.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/AmazonECS/latest/developerguide/ecs-anywhere-deregistration.html)

------