Mettre à jour 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 Exécuter Connectivity Tests.

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

Avant de commencer

Configurez les éléments suivants dans Google Cloud avant d'utiliser les tests de connectivité :

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

    Accéder à la page de sélection du projet

  2. Sélectionnez ou créez un projet Google Cloud.
  3. Assurez-vous que la facturation est activée pour votre projet Cloud.

Les procédures décrites dans ce document sont les suivantes :

  • Exemples d'appels d'API qui utilisent l'API Network Management Pour plus d'informations, consultez la section Documentation sur l'API.

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

Utiliser le client Python de l'API

L'exemple de code présenté dans ce document 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, consultez les ressources suivantes :

Utiliser l'API Explorer

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.

Utiliser le SDK gcloud

L'outil de ligne de commande gcloud fait partie du SDK Cloud. Pour installer la dernière version de l'outil de ligne de commande gcloud, consultez la documentation du SDK Cloud.

Pour obtenir la liste de toutes les commandes, reportez-vous à la documentation de référence sur les commandesgcloud.

Vérifier une opération de test en cours d'exécution

Pour vérifier l'état d'une opération de test pendant son exécution, reportez-vous à la page Vérifier une opération de test en cours.

update et delete sont deux exemples d'opérations de test.

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.

Console

Depuis la page principale Tests de connectivité

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

    Accéder à la page 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 Edit (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 Edit (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

Console

Depuis la page principale Tests de connectivité

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

    Accéder à la page 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