Modifier ou supprimer des tests de connectivité

Découvrez comment modifier ou supprimer des tests de connectivité en suivant la procédure présentée sur cette page. Vous pouvez modifier ou supprimer des tests créés par vous et par d'autres utilisateurs.

Pour créer, afficher ou réexécuter des tests, consultez la page Créer et exécuter des tests de connectivité.

Pour en savoir plus sur les tests de connectivité, consultez la présentation.

Avant de commencer

Pour pouvoir utiliser des tests de connectivité, configurez les éléments suivants dans Google Cloud :

  1. Dans Google Cloud Console, accédez à la page de sélection du projet.

    Accéder au sélecteur de projet

    Sélectionnez ou créez un projet Google Cloud.

  2. Assurez-vous que la facturation est activée pour votre projet Google Cloud.
  3. Installez l'outil de ligne de commande gcloud, qui fait partie du SDK Cloud. Pour installer la dernière version de l'outil gcloud, consultez la documentation du SDK Cloud.

    Pour obtenir la liste de toutes les commandes, consultez la documentation de référence sur les commandes gcloud.

  4. Activer l'API Network Management L'activation de l'API vous permet de bénéficier des éléments suivants :

    • Exemples d'appels d'API qui utilisent l'API Network Management

      Vous pouvez tester les commandes de l'API Network Management à l'aide de l'explorateur d'API. Dans la documentation de référence de l'API Network Management, reportez-vous à la colonne Try this API pour explorer les champs de l'API et exécuter un test.

    • Exemple de code qui utilise le client Python de l'API

      L'exemple de code suppose que vous avez créé une ressource nommée api pour interagir avec l'API Network Management. Pour créer une ressource, utilisez la fonction build. Consultez l'exemple ci-dessous :

      from googleapiclient.discovery import build
      api = build('networkmanagement', 'v1')
      

      Pour en savoir plus sur le client Python de l'API, consultez les pages suivantes :

  5. Obtenez les autorisations nécessaires pour exécuter et afficher les tests. Pour en savoir plus, consultez la section Attribuer des accès.

Mettre à jour un test

Suivez les étapes de cette section pour mettre à jour un test. Vous pouvez modifier n'importe quel champ du test à l'exception du champ name.

Pour vérifier l'état de l'opération de test update pendant son exécution, consultez la page Vérifier une opération de test en cours.

Console

Depuis la page principale Tests de connectivité

  1. Dans Google Cloud Console, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Pour mettre à jour un test, cliquez sur son nom.

  3. Sur la page Informations sur le test de connectivité, cliquez sur Modifier en haut de la page.

  4. Modifiez les options du test.

  5. Cliquez sur Enregistrer.

    Le test est réexécuté automatiquement.

Depuis la page d'informations "Interface réseau"

  1. Dans Google Cloud Console, accédez à la page Instances de VM.

    Accéder à la page "Instances de VM"

  2. Si ce n'est pas déjà fait, sélectionnez le projet contenant l'instance pour laquelle vous souhaitez mettre à jour un test.

  3. Cliquez sur l'instance pour laquelle vous souhaitez mettre à jour un test.

  4. Sous Interfaces réseau, sélectionnez l'interface réseau pour laquelle vous souhaitez mettre à jour un test.

  5. Sous Analyse du réseau, cliquez sur Tests de connectivité.

  6. Cliquez sur le Nom du test à mettre à jour.

  7. Sur la page Informations sur le test de connectivité, cliquez sur Modifier en haut de la page.

  8. Modifiez les options du test.

  9. Cliquez sur Enregistrer.

    Le test est réexécuté automatiquement.

gcloud

Pour mettre à jour un test, entrez la commande suivante en utilisant l'ID de test que vous souhaitez mettre à jour et les options de commande que vous souhaitez modifier. L'exemple suivant modifie l'adresse IP de destination.

  gcloud network-management connectivity-tests update NAME \
    --destination-ip-address= DESTINATION_IP_ADDRESS

Remplacez les valeurs suivantes :

  • NAME : nom du test de connectivité
  • DESTINATION_IP_ADDRESS : adresse IP de destination interne ou externe vers laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global

API

Utilisez la méthode networkmanagement.connectivitytests.patch pour mettre à jour (modifier) un test.

  PATCH https: //networkmanagement.googleapis.com/v1/{resource.name=projects/PROJECT_ID/locations/global/connectivityTests/TEST_ID}
    {
      "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "projectId": "SOURCE_PROJECT",
      },
    }

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez.
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global.
  • SOURCE_PROJECT : ID de projet du point de terminaison source

Python

L'exemple de code ci-dessous permet de mettre à jour l'adresse IP source d'un test. Pour en savoir plus, consultez la section patch dans la documentation de référence du client Python de l'API.

project_id = "PROJECT_ID"
test_id = "TEST_ID"
test_input = {
  "source": {
    "ipAddress": "SOURCE_IP_ADDRESS"
  },
}

request = api.projects().locations().global_().connectivityTests().patch(
  name='projects/%s/locations/global/connectivityTests/%s' % (project_id, test_id),
  body=test_input,
  updateMask="source")

print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID du projet dans lequel le test a été créé
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez
  • SOURCE_IP_ADDRESS : adresse IP source interne ou externe à partir de laquelle vous effectuez les tests. Une adresse IPv6 n'est autorisée que lorsque la destination du test est une adresse IP virtuelle d'équilibreur de charge global

updateMask est un paramètre obligatoire qui spécifie les champs mis à jour par votre correctif. Cet exemple met à jour le champ source.

Supprimer un ou plusieurs tests

Suivez les étapes de cette section pour supprimer un test.

Pour vérifier l'état de l'opération de test delete pendant son exécution, consultez la page Vérifier une opération de test en cours.

Console

Depuis la page principale Tests de connectivité

  1. Dans Google Cloud Console, accédez à la page Tests de connectivité.

    Accéder à Tests de connectivité

  2. Cochez la case située à gauche d'un ou plusieurs tests à supprimer.

  3. En haut de la page Cloud Console, cliquez sur Supprimer .

Depuis la page d'informations "Tests de connectivité"

  1. Sur la page principale Connectivity Tests, cliquez sur le nom d'un test.
  2. En haut de la page Informations sur le test de connectivité, cliquez sur Supprimer .

Depuis la page d'informations "Interface réseau"

  1. Dans Google Cloud Console, accédez à la page Instances de VM.

    Accéder à la page "Instances de VM"

  2. Si ce n'est pas déjà fait, sélectionnez le projet contenant l'instance à partir de laquelle vous souhaitez supprimer un test.

  3. Cliquez sur l'instance à partir de laquelle vous souhaitez supprimer un test.

  4. Sous Interfaces réseau, sélectionnez l'interface réseau à partir de laquelle vous souhaitez supprimer un test.

  5. Sous Analyse du réseau, cliquez sur Tests de connectivité.

  6. Cochez la case située à gauche d'un ou plusieurs tests à supprimer.

  7. En haut de la liste des tests, cliquez sur Delete (Supprimer) .

gcloud

Pour supprimer un test, entrez la commande suivante. Utilisez l'ID de test pour le test que vous souhaitez supprimer.

  gcloud beta network-management connectivity-tests delete NAME

Remplacez NAME par le nom du test de connectivité.

API

Utilisez la méthode networkmanagement.connectivitytests.delete pour supprimer un test.

DELETE https://networkmanagement.googleapis.com/v1/{name=projects/PROJECT_ID/locations/global/connectivityTests/{TEST_ID}

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID de projet de la VM source.
  • TEST_ID : ID de l'objet de test de connectivité (test) que vous exécutez

Python

L'exemple de code suivant supprime un test. Pour en savoir plus, consultez delete dans la documentation de référence du client Python de l'API.

project_id = "PROJECT_ID"
test_id = "TEST_ID"
request = api.projects().locations().global_().connectivityTests().delete(
          name='projects/%s/locations/global/connectivityTests/%s' % (project_id, test_id))

print(json.dumps(request.execute(), indent=4))

Remplacez les valeurs suivantes :

  • PROJECT_ID : ID du projet dans lequel le test a été créé
  • TEST_ID : ID de l'objet (test de connectivité) que vous souhaitez supprimer

Étape suivante