gcloud network-management connectivity-tests update

NAME
gcloud network-management connectivity-tests update - update an existing connectivity test
SYNOPSIS
gcloud network-management connectivity-tests updateCONNECTIVITY_TEST[--async][--bypass-firewall-checks][--description=DESCRIPTION][--destination-fqdn=DESTINATION_FQDN][--destination-network=DESTINATION_NETWORK][--destination-port=DESTINATION_PORT][--destination-project=DESTINATION_PROJECT][--labels=[KEY=VALUE,…]][--other-projects=[OTHER_PROJECTS,…]][--protocol=PROTOCOL][--round-trip][--source-network=SOURCE_NETWORK][--source-network-type=SOURCE_NETWORK_TYPE; default="gcp-network"][--source-project=SOURCE_PROJECT][--clear-destination-cloud-sql-instance    |--destination-cloud-sql-instance=DESTINATION_CLOUD_SQL_INSTANCE][--clear-destination-forwarding-rule    |--destination-forwarding-rule=DESTINATION_FORWARDING_RULE][--clear-destination-gke-master-cluster    |--destination-gke-master-cluster=DESTINATION_GKE_MASTER_CLUSTER][--clear-destination-instance    |--destination-instance=DESTINATION_INSTANCE][--clear-destination-ip-address    |--destination-ip-address=DESTINATION_IP_ADDRESS][--clear-destination-redis-cluster    |--destination-redis-cluster=DESTINATION_REDIS_CLUSTER][--clear-destination-redis-instance    |--destination-redis-instance=DESTINATION_REDIS_INSTANCE][--clear-source-app-engine-version    |--source-app-engine-version=SOURCE_APP_ENGINE_VERSION][--clear-source-cloud-function    |--source-cloud-function=SOURCE_CLOUD_FUNCTION][--clear-source-cloud-run-revision    |--source-cloud-run-revision=SOURCE_CLOUD_RUN_REVISION][--clear-source-cloud-sql-instance    |--source-cloud-sql-instance=SOURCE_CLOUD_SQL_INSTANCE][--clear-source-gke-master-cluster    |--source-gke-master-cluster=SOURCE_GKE_MASTER_CLUSTER][--clear-source-instance    |--source-instance=SOURCE_INSTANCE][--clear-source-ip-address    |--source-ip-address=SOURCE_IP_ADDRESS][GCLOUD_WIDE_FLAG]
DESCRIPTION
Update an existing connectivity test with the given name.
EXAMPLES
The following command updates a connectivity test with the name my-test,modifying the description and destination IP address.
gcloudnetwork-managementconnectivity-testsupdatemy-test--description='update dst addr'--destination-ip-address='10.142.0.3'
POSITIONAL ARGUMENTS
Connectivity test resource - Name of the connectivity test you want to update.This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.

To set theproject attribute:

  • provide the argumentconnectivity_test on the command line with afully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

CONNECTIVITY_TEST
ID of the connectivity test or fully qualified identifier for the connectivitytest.

To set theconnectivity_test attribute:

  • provide the argumentconnectivity_test on the command line.
FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--bypass-firewall-checks
This boolean controls whether to skip firewall checking. Use--no-bypass-firewall-checks to disable.
--description=DESCRIPTION
The description of the connectivity test.
--destination-fqdn=DESTINATION_FQDN
A hostname as the destination endpoint. Only applicable for Google KubernetesEngine.
--destination-network=DESTINATION_NETWORK
A VPC network URI where the destination is located.
--destination-port=DESTINATION_PORT
The IP protocol port of the destination. Only applicable when protocol is TCP orUDP.
--destination-project=DESTINATION_PROJECT
Project ID of the destination endpoint.
--labels=[KEY=VALUE,…]
List of label KEY=VALUE pairs to add.
--other-projects=[OTHER_PROJECTS,…]
IDs of other projects involved in the connectivity test, besides the source anddestination project.
--protocol=PROTOCOL
Type of protocol for the test. When not provided, "TCP" is assumed.
--round-trip
This boolean controls whether return traces (from the destination to the source)will be additionally calculated if packet successfully reaches the destinationfrom the source. Use --no-round-trip to disable.
--source-network=SOURCE_NETWORK
A VPC network URI where the source is located.
--source-network-type=SOURCE_NETWORK_TYPE; default="gcp-network"
Type of the network where the source is located.SOURCE_NETWORK_TYPE must be one of:
gcp-network
Network in Google Cloud Platform.
non-gcp-network
Network outside Google Cloud Platform.
--source-project=SOURCE_PROJECT
Project ID of the source endpoint.
At most one of these can be specified:
--clear-destination-cloud-sql-instance
Clear existing destination Cloud SQL instance.
--destination-cloud-sql-instance=DESTINATION_CLOUD_SQL_INSTANCE
A Cloud SQL instance URI as the destination endpoint.
At most one of these can be specified:
--clear-destination-forwarding-rule
Clear existing destination forwarding rule.
--destination-forwarding-rule=DESTINATION_FORWARDING_RULE
A forwarding rule URI as the destination endpoint.
At most one of these can be specified:
--clear-destination-gke-master-cluster
Clear existing destination cluster for Google Kubernetes Engine master.
--destination-gke-master-cluster=DESTINATION_GKE_MASTER_CLUSTER
A cluster URI for Google Kubernetes Engine master as the destination endpoint.
At most one of these can be specified:
--clear-destination-instance
Clear existing destination instance.
--destination-instance=DESTINATION_INSTANCE
A Compute Engine instance URI as the destination endpoint.
At most one of these can be specified:
--clear-destination-ip-address
Clear existing destination IP address.
--destination-ip-address=DESTINATION_IP_ADDRESS
The IP address of the destination which can be an external or internal IP.
At most one of these can be specified:
--clear-destination-redis-cluster
Clear existing destination Redis Cluster.
--destination-redis-cluster=DESTINATION_REDIS_CLUSTER
A Redis cluster URI as the destination endpoint.
At most one of these can be specified:
--clear-destination-redis-instance
Clear existing destination Redis Instance.
--destination-redis-instance=DESTINATION_REDIS_INSTANCE
A Redis instance URI as the destination endpoint.
At most one of these can be specified:
--clear-source-app-engine-version
Clear existing source App Engine version.
--source-app-engine-version=SOURCE_APP_ENGINE_VERSION
App Engine version URI as the source endpoint.
At most one of these can be specified:
--clear-source-cloud-function
Clear existing source Cloud function.
--source-cloud-function=SOURCE_CLOUD_FUNCTION
A Cloud function URI as the source endpoint.
At most one of these can be specified:
--clear-source-cloud-run-revision
Clear existing source Cloud Run revision.
--source-cloud-run-revision=SOURCE_CLOUD_RUN_REVISION
Cloud Run revision URI as the source endpoint.
At most one of these can be specified:
--clear-source-cloud-sql-instance
Clear existing source Cloud SQL instance.
--source-cloud-sql-instance=SOURCE_CLOUD_SQL_INSTANCE
A Cloud SQL instance URI as the source endpoint.
At most one of these can be specified:
--clear-source-gke-master-cluster
Clear existing source cluster for Google Kubernetes Engine master.
--source-gke-master-cluster=SOURCE_GKE_MASTER_CLUSTER
A cluster URI for Google Kubernetes Engine master as the source endpoint.
At most one of these can be specified:
--clear-source-instance
Clear existing source instance.
--source-instance=SOURCE_INSTANCE
A Compute Engine instance URI as the source endpoint.
At most one of these can be specified:
--clear-source-ip-address
Clear existing source IP address.
--source-ip-address=SOURCE_IP_ADDRESS
The IP address of the source which can be an external or internal IP.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

API REFERENCE
This command uses thenetworkmanagement/v1 API. The fulldocumentation for this API can be found at:https://cloud.google.com/
NOTES
This variant is also available:
gcloudbetanetwork-managementconnectivity-testsupdate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.