Method: projects.locations.global.connectivityTests.create

Crée un nouveau test de connectivité. Après avoir créé un test, l'analyse de joignabilité est effectuée dans le cadre de l'opération de longue durée, qui se termine lorsque l'analyse est terminée.

Si les spécifications du point de terminaison dans ConnectivityTest ne sont pas valides (par exemple, contenant des ressources inexistantes dans le réseau, ou si vous ne disposez pas des autorisations de lecture sur les configurations réseau des projets répertoriés), le résultat de joignabilité renvoie une valeur UNKNOWN.

Si les spécifications du point de terminaison dans ConnectivityTest sont incomplètes, le résultat de joignabilité renvoie une valeur

AMBIGUOUS

. Pour en savoir plus, consultez la documentation sur le test de connectivité.

Requête HTTP

POST https://networkmanagement.googleapis.com/v1beta1/{parent=projects/*/locations/global}/connectivityTests

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. La ressource parente du test de connectivité à créer : projects/{projectId}/locations/global

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • networkmanagement.connectivitytests.create

Paramètres de requête

Paramètres
testId

string

Obligatoire. Nom logique du test de connectivité dans votre projet avec les restrictions suivantes :

  • Doit être composé de lettres minuscules, de chiffres et de traits d'union.
  • Doit commencer par une lettre.
  • Doit comporter entre 1 et 40 caractères.
  • Doit se terminer par un chiffre ou une lettre.
  • Doit être unique dans le projet client.

Corps de la requête

Le corps de la requête contient une instance de ConnectivityTest.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.