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

Updates the configuration of an existing ConnectivityTest. After you update a test, the reachability analysis is performed as part of the long running operation, which completes when the analysis completes. The Reachability state in the test resource is updated with the new result.

If the endpoint specifications in ConnectivityTest are invalid (for example, they contain non-existent resources in the network, or the user does not have read permissions to the network configurations of listed projects), then the reachability result returns a value of



If the endpoint specifications in ConnectivityTest are incomplete, the reachability result returns a value of AMBIGUOUS. See the documentation in ConnectivityTest for for more details.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Unique name of the resource using the form: projects/{projectId}/locations/global/connectivityTests/{testId}

Query parameters


string (FieldMask format)

Required. Mask of fields to update. At least one path must be supplied in this field.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

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

  • networkmanagement.connectivitytests.update

Request body

The request body contains an instance of ConnectivityTest.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.