Stay organized with collections Save and categorize content based on your preferences.

Creates a new Connectivity Test. After you create a test, the reachability analysis is performed as part of the long running operation, which completes when the analysis completes.

If the endpoint specifications in ConnectivityTest are invalid (for example, containing non-existent resources in the network, or you don't have read permissions to the network configurations of listed projects), then the reachability result returns a value of UNKNOWN.

If the endpoint specifications in ConnectivityTest are incomplete, the reachability result returns a value of


. For more information, see the Connectivity Test documentation.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent resource of the Connectivity Test to create: projects/{projectId}/locations/global

Authorization requires the following IAM permission on the specified resource parent:

  • networkmanagement.connectivitytests.create

Query parameters



Required. The logical name of the Connectivity Test in your project with the following restrictions:

  • Must contain only lowercase letters, numbers, and hyphens.
  • Must start with a letter.
  • Must be between 1-40 characters.
  • Must end with a number or a letter.
  • Must be unique within the customer project

Request body

The request body contains an instance of ConnectivityTest.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.