Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Supprimer une MediaConnect passerelle
<a name="gateway-cleanup-console"></a>



Pour supprimer une passerelle, vous devez d'abord supprimer tous ses composants, tels que ses réseaux, ses instances et ses ponts. Le processus de suppression d'une passerelle et de ses composants est le suivant.

**Contents**
+ [Conditions préalables](#gateway-cleanup-prerequisites)
+ [Procédure](#gateway-cleanup-procedure)

## Conditions préalables
<a name="gateway-cleanup-prerequisites"></a>

La procédure suivante suppose que vous avez déjà créé au moins une MediaConnect passerelle.

## Procédure
<a name="gateway-cleanup-procedure"></a>

Vous pouvez supprimer une passerelle à l'aide de la console ou du AWS CLI.

------
#### [ Console ]

**Pour supprimer une passerelle à l'aide de la console**

1. Ouvrez la MediaConnect console à l'adresse [https://console.aws.amazon.com/mediaconnect/](https://console.aws.amazon.com/mediaconnect/).

1. Dans le volet de navigation, sélectionnez **Gateways**. Dans la section **Passerelles**, sélectionnez la passerelle que vous souhaitez supprimer. 

1. Sur la page de détails de la MediaConnect passerelle, sélectionnez l'onglet **Ponts**. Procédez comme suit pour supprimer les ponts :

   1. Sélectionnez le pont que vous souhaitez supprimer.

   1. Si le pont a été démarré, sélectionnez **Arrêter**.

   1. Lorsque le pont est arrêté, sélectionnez **Supprimer**.

   1. Confirmez la suppression du pont en sélectionnant **Supprimer le pont**.

   1. Répétez ces étapes pour tous les ponts supplémentaires que vous devez supprimer.

1. Retournez à la page **Détails** de la passerelle, sélectionnez l'onglet **Instances**. Procédez comme suit pour supprimer les instances :

   1. Sélectionnez l'instance que vous souhaitez supprimer.

   1. Sélectionnez **Désenregistrer**.

   1. **Confirmez le désenregistrement de l'instance en sélectionnant Désenregistrer l'instance.**

   1. Répétez ces étapes pour toutes les instances supplémentaires dont vous avez besoin pour annuler l'enregistrement.
**Note**  
**FACULTATIF** : Si vous souhaitez réutiliser l'instance pour Amazon ECS Anywhere ou en tant qu'autre instance de passerelle, vous devez suivre les étapes suivantes. Si ce n'est pas le cas, passez à l'étape 5.

   1. Assurez-vous que l'**état de l'instance** est **Désenregistré** pour l'instance que vous souhaitez réutiliser.

   1. À partir d'un ordinateur disposant de cet accès, connectez-vous à l'instance via SSH.

   1. Exécutez les commandes suivantes, dans l'ordre :

      ```
      sudo docker stop $(sudo docker ps -f "name=MediaConnectGatewayAgent" -q); \
      sudo docker stop ecs-agent; \
      sudo systemctl stop ecs amazon-ssm-agent; \
      sudo yum remove -y amazon-ecs-init amazon-ssm-agent;  `# or apt or snap as needed` \
      sudo rm /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm -rf; \
      sudo docker rm -f ecs-agent ssm-agent; \
      sudo docker container rm -f $(sudo docker ps -a -f "name=MediaConnectGatewayAgent" -q); \
      sudo docker volume rm -f ecsdata docker run; \
      sudo pkill -f -KILL network_bootstra[p]; \
      sudo pkill -KILL mcproxy;
      ```

1. Après avoir correctement supprimé tous les ponts et désenregistré toutes les instances associées à la passerelle, vous pouvez supprimer la passerelle. La suppression de la passerelle entraîne la suppression de tous les réseaux créés sous cette passerelle.

   1. Dans le volet de navigation, sélectionnez **Gateways**. 

   1. Dans la section **Passerelles**, sélectionnez la passerelle que vous souhaitez supprimer pour afficher la page de **détails** de cette passerelle.

   1. Choisissez le bouton **Supprimer**.

   1. Confirmez la suppression de la passerelle en choisissant **Supprimer la passerelle**.

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

**Pour supprimer une passerelle à l'aide du AWS CLI**

1. Supprimez les ponts en exécutant la commande suivante.

   ```
   aws --profile <Profile> --region <Region> mediaconnect delete-bridge --bridge-arn <BridgeArn>
   ```

1. Désenregistrez les instances en exécutant la commande suivante.

   ```
   aws --profile <Profile> --region <Region> mediaconnect deregister-gateway-instance --gateway-instance-arn <GatewayArn>
   ```
**Note**  
**FACULTATIF** : Si vous souhaitez réutiliser l'instance pour Amazon ECS Anywhere ou en tant qu'autre instance AWS Elemental MediaConnect Gateway, vous devez suivre les étapes suivantes. Si ce n'est pas le cas, passez à l'étape 3.

   1. Assurez-vous qu'il s'`InstanceState`agit `DEREGISTERED` de l'instance que vous souhaitez réutiliser. Vous pouvez vérifier à l'aide de la `describe-gateway-instance` commande illustrée dans l'exemple suivant. 

      ```
      aws --profile <Profile> --region <Region> mediaconnect describe-gateway-instance
            --gateway-instance-arn <GatewayInstanceArn>
      ```

   1. À partir d'un ordinateur disposant de cet accès, connectez-vous à l'instance via SSH.

   1. Exécutez les commandes suivantes, dans l'ordre.

      ```
      sudo docker stop $(sudo docker ps -f "name=MediaConnectGatewayAgent" -q); \
      sudo docker stop ecs-agent; \
      sudo systemctl stop ecs amazon-ssm-agent; \
      sudo yum remove -y amazon-ecs-init amazon-ssm-agent;  `# or apt or snap as needed` \
      sudo rm /var/lib/ecs /etc/ecs /var/lib/amazon/ssm /var/log/ecs /var/log/amazon/ssm -rf; \
      sudo docker rm -f ecs-agent ssm-agent; \
      sudo docker container rm -f $(sudo docker ps -a -f "name=MediaConnectGatewayAgent" -q); \
      sudo docker volume rm -f ecsdata docker run; \
      sudo pkill -f -KILL network_bootstra[p]; \
      sudo pkill -KILL mcproxy;
      ```

1. Supprimez la passerelle. Cela supprimera tous les réseaux associés à la passerelle.

   ```
   aws --profile <Profile> --region <Region> mediaconnect delete-gateway --gateway-arn <GatewayArn>
   ```

------