Découvrez comment modifier ou supprimer des tests en suivant la procédure décrite 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
Before you can use Connectivity Tests, set up the following items in Google Cloud:
In the Google Cloud console, go to the project selector page.
Select or create a Google Cloud project.
- Ensure that billing is enabled for your Google Cloud project.
Install the Google Cloud CLI, which is part of the Google Cloud CLI. To install the latest version of the gcloud CLI, see the gcloud CLI documentation.
For a list of all commands, see the
gcloudcommand reference.Enable the Network Management API. Enabling the API provides you with the following:
Example API calls that use the Network Management API
You can test Network Management API commands by using the API Explorer. In the Network Management API reference document, use the
Try this APIcolumn to explore API fields and run a test.Sample code that uses the API Python client
The example code assumes that you have constructed a resource named
apito interact with the Network Management API. To construct a resource, use thebuildfunction. See the following example:from googleapiclient.discovery import build api = build('networkmanagement', 'v1')For more information about the API Python client, see the following:
- Google API Client Library for Python Docs in GitHub, which includes installation and authentication instructions.
- The Network Management API reference documentation for the API Python client.
- Obtain the permissions that you need to run and view tests. For details, see Assign access.
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é
Dans la Google Cloud console, accédez à la page Tests de connectivité.
Pour mettre à jour un test, cliquez sur son nom.
Sur la page Informations sur le test de connectivité, cliquez sur Edit (Modifier) en haut de la page.
Modifiez les options du test.
Cliquez sur Enregistrer.
Le test est réexécuté automatiquement.
Depuis la page d'informations Interface réseau
Dans la console Google Cloud , accédez à la page Instances de VM.
Si ce n'est pas déjà fait, sélectionnez le projet contenant l'instance pour laquelle vous souhaitez mettre à jour un test.
Cliquez sur l'instance pour laquelle vous souhaitez mettre à jour un test.
Sous Interfaces réseau, sélectionnez l'interface réseau pour laquelle vous souhaitez mettre à jour un test.
Sous Analyse du réseau, cliquez sur Tests de connectivité.
Cliquez sur le Nom du test à mettre à jour.
Sur la page Informations sur le test de connectivité, cliquez sur Edit (Modifier) en haut de la page.
Modifiez les options du test.
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écutezSOURCE_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é
Dans la Google Cloud console, accédez à la page Tests de connectivité.
Cochez la case située à gauche d'un ou plusieurs tests à supprimer.
En haut de la page de la Google Cloud console, cliquez sur Supprimer .
Depuis la page d'informations Tests de connectivité
- Sur la page principale Connectivity Tests, cliquez sur le nom d'un test.
- En haut de la page Informations sur le test de connectivité, cliquez sur Supprimer .
Depuis la page d'informations Interface réseau
Dans la console Google Cloud , accédez à la page Instances de VM.
Si ce n'est pas déjà fait, sélectionnez le projet contenant l'instance à partir de laquelle vous souhaitez supprimer un test.
Cliquez sur l'instance à partir de laquelle vous souhaitez supprimer un test.
Sous Interfaces réseau, sélectionnez l'interface réseau à partir de laquelle vous souhaitez supprimer un test.
Sous Analyse du réseau, cliquez sur Tests de connectivité.
Cochez la case située à gauche d'un ou plusieurs tests à supprimer.
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