.TH "GCLOUD_NETWORK\-MANAGEMENT_CONNECTIVITY\-TESTS_UPDATE" 1



.SH "NAME"
.HP
gcloud network\-management connectivity\-tests update \- update an existing connectivity test



.SH "SYNOPSIS"
.HP
\f5gcloud network\-management connectivity\-tests update\fR \fICONNECTIVITY_TEST\fR [\fB\-\-async\fR] [\fB\-\-bypass\-firewall\-checks\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-destination\-fqdn\fR=\fIDESTINATION_FQDN\fR] [\fB\-\-destination\-network\fR=\fIDESTINATION_NETWORK\fR] [\fB\-\-destination\-port\fR=\fIDESTINATION_PORT\fR] [\fB\-\-destination\-project\fR=\fIDESTINATION_PROJECT\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-other\-projects\fR=[\fIOTHER_PROJECTS\fR,...]] [\fB\-\-protocol\fR=\fIPROTOCOL\fR] [\fB\-\-round\-trip\fR] [\fB\-\-source\-network\fR=\fISOURCE_NETWORK\fR] [\fB\-\-source\-network\-type\fR=\fISOURCE_NETWORK_TYPE\fR;\ default="gcp\-network"] [\fB\-\-source\-project\fR=\fISOURCE_PROJECT\fR] [\fB\-\-clear\-destination\-cloud\-sql\-instance\fR\ |\ \fB\-\-destination\-cloud\-sql\-instance\fR=\fIDESTINATION_CLOUD_SQL_INSTANCE\fR] [\fB\-\-clear\-destination\-forwarding\-rule\fR\ |\ \fB\-\-destination\-forwarding\-rule\fR=\fIDESTINATION_FORWARDING_RULE\fR] [\fB\-\-clear\-destination\-gke\-master\-cluster\fR\ |\ \fB\-\-destination\-gke\-master\-cluster\fR=\fIDESTINATION_GKE_MASTER_CLUSTER\fR] [\fB\-\-clear\-destination\-instance\fR\ |\ \fB\-\-destination\-instance\fR=\fIDESTINATION_INSTANCE\fR] [\fB\-\-clear\-destination\-ip\-address\fR\ |\ \fB\-\-destination\-ip\-address\fR=\fIDESTINATION_IP_ADDRESS\fR] [\fB\-\-clear\-destination\-redis\-cluster\fR\ |\ \fB\-\-destination\-redis\-cluster\fR=\fIDESTINATION_REDIS_CLUSTER\fR] [\fB\-\-clear\-destination\-redis\-instance\fR\ |\ \fB\-\-destination\-redis\-instance\fR=\fIDESTINATION_REDIS_INSTANCE\fR] [\fB\-\-clear\-source\-app\-engine\-version\fR\ |\ \fB\-\-source\-app\-engine\-version\fR=\fISOURCE_APP_ENGINE_VERSION\fR] [\fB\-\-clear\-source\-cloud\-function\fR\ |\ \fB\-\-source\-cloud\-function\fR=\fISOURCE_CLOUD_FUNCTION\fR] [\fB\-\-clear\-source\-cloud\-run\-revision\fR\ |\ \fB\-\-source\-cloud\-run\-revision\fR=\fISOURCE_CLOUD_RUN_REVISION\fR] [\fB\-\-clear\-source\-cloud\-sql\-instance\fR\ |\ \fB\-\-source\-cloud\-sql\-instance\fR=\fISOURCE_CLOUD_SQL_INSTANCE\fR] [\fB\-\-clear\-source\-gke\-master\-cluster\fR\ |\ \fB\-\-source\-gke\-master\-cluster\fR=\fISOURCE_GKE_MASTER_CLUSTER\fR] [\fB\-\-clear\-source\-instance\fR\ |\ \fB\-\-source\-instance\fR=\fISOURCE_INSTANCE\fR] [\fB\-\-clear\-source\-ip\-address\fR\ |\ \fB\-\-source\-ip\-address\fR=\fISOURCE_IP_ADDRESS\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update an existing connectivity test with the given name.



.SH "EXAMPLES"

The following command updates a connectivity test with the name my\-test,
modifying the description and destination IP address.

.RS 2m
$ gcloud network\-management connectivity\-tests update my\-test \e
    \-\-description='update dst addr' \e
    \-\-destination\-ip\-address='10.142.0.3'
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Connectivity test resource \- Name of the connectivity test you want to update.
This represents a Cloud resource. (NOTE) Some attributes are not given arguments
in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5connectivity_test\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fICONNECTIVITY_TEST\fR

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

To set the \f5connectivity_test\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5connectivity_test\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-bypass\-firewall\-checks\fR

This boolean controls whether to skip firewall checking. Use
\-\-no\-bypass\-firewall\-checks to disable.

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

The description of the connectivity test.

.TP 2m
\fB\-\-destination\-fqdn\fR=\fIDESTINATION_FQDN\fR

A hostname as the destination endpoint. Only applicable for Google Kubernetes
Engine.

.TP 2m
\fB\-\-destination\-network\fR=\fIDESTINATION_NETWORK\fR

A VPC network URI where the destination is located.

.TP 2m
\fB\-\-destination\-port\fR=\fIDESTINATION_PORT\fR

The IP protocol port of the destination. Only applicable when protocol is TCP or
UDP.

.TP 2m
\fB\-\-destination\-project\fR=\fIDESTINATION_PROJECT\fR

Project ID of the destination endpoint.

.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to add.

.TP 2m
\fB\-\-other\-projects\fR=[\fIOTHER_PROJECTS\fR,...]

IDs of other projects involved in the connectivity test, besides the source and
destination project.

.TP 2m
\fB\-\-protocol\fR=\fIPROTOCOL\fR

Type of protocol for the test. When not provided, "TCP" is assumed.

.TP 2m
\fB\-\-round\-trip\fR

This boolean controls whether return traces (from the destination to the source)
will be additionally calculated if packet successfully reaches the destination
from the source. Use \-\-no\-round\-trip to disable.

.TP 2m
\fB\-\-source\-network\fR=\fISOURCE_NETWORK\fR

A VPC network URI where the source is located.

.TP 2m
\fB\-\-source\-network\-type\fR=\fISOURCE_NETWORK_TYPE\fR; default="gcp\-network"

Type of the network where the source is located. \fISOURCE_NETWORK_TYPE\fR must
be one of:

.RS 2m
.TP 2m
\fBgcp\-network\fR
Network in Google Cloud Platform.
.TP 2m
\fBnon\-gcp\-network\fR
Network outside Google Cloud Platform.
.RE
.sp


.TP 2m
\fB\-\-source\-project\fR=\fISOURCE_PROJECT\fR

Project ID of the source endpoint.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-destination\-cloud\-sql\-instance\fR

Clear existing destination Cloud SQL instance.

.TP 2m
\fB\-\-destination\-cloud\-sql\-instance\fR=\fIDESTINATION_CLOUD_SQL_INSTANCE\fR

A Cloud SQL instance URI as the destination endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-destination\-forwarding\-rule\fR

Clear existing destination forwarding rule.

.TP 2m
\fB\-\-destination\-forwarding\-rule\fR=\fIDESTINATION_FORWARDING_RULE\fR

A forwarding rule URI as the destination endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-destination\-gke\-master\-cluster\fR

Clear existing destination cluster for Google Kubernetes Engine master.

.TP 2m
\fB\-\-destination\-gke\-master\-cluster\fR=\fIDESTINATION_GKE_MASTER_CLUSTER\fR

A cluster URI for Google Kubernetes Engine master as the destination endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-destination\-instance\fR

Clear existing destination instance.

.TP 2m
\fB\-\-destination\-instance\fR=\fIDESTINATION_INSTANCE\fR

A Compute Engine instance URI as the destination endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-destination\-ip\-address\fR

Clear existing destination IP address.

.TP 2m
\fB\-\-destination\-ip\-address\fR=\fIDESTINATION_IP_ADDRESS\fR

The IP address of the destination which can be an external or internal IP.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-destination\-redis\-cluster\fR

Clear existing destination Redis Cluster.

.TP 2m
\fB\-\-destination\-redis\-cluster\fR=\fIDESTINATION_REDIS_CLUSTER\fR

A Redis cluster URI as the destination endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-destination\-redis\-instance\fR

Clear existing destination Redis Instance.

.TP 2m
\fB\-\-destination\-redis\-instance\fR=\fIDESTINATION_REDIS_INSTANCE\fR

A Redis instance URI as the destination endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-source\-app\-engine\-version\fR

Clear existing source App Engine version.

.TP 2m
\fB\-\-source\-app\-engine\-version\fR=\fISOURCE_APP_ENGINE_VERSION\fR

App Engine version URI as the source endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-source\-cloud\-function\fR

Clear existing source Cloud function.

.TP 2m
\fB\-\-source\-cloud\-function\fR=\fISOURCE_CLOUD_FUNCTION\fR

A Cloud function URI as the source endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-source\-cloud\-run\-revision\fR

Clear existing source Cloud Run revision.

.TP 2m
\fB\-\-source\-cloud\-run\-revision\fR=\fISOURCE_CLOUD_RUN_REVISION\fR

Cloud Run revision URI as the source endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-source\-cloud\-sql\-instance\fR

Clear existing source Cloud SQL instance.

.TP 2m
\fB\-\-source\-cloud\-sql\-instance\fR=\fISOURCE_CLOUD_SQL_INSTANCE\fR

A Cloud SQL instance URI as the source endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-source\-gke\-master\-cluster\fR

Clear existing source cluster for Google Kubernetes Engine master.

.TP 2m
\fB\-\-source\-gke\-master\-cluster\fR=\fISOURCE_GKE_MASTER_CLUSTER\fR

A cluster URI for Google Kubernetes Engine master as the source endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-source\-instance\fR

Clear existing source instance.

.TP 2m
\fB\-\-source\-instance\fR=\fISOURCE_INSTANCE\fR

A Compute Engine instance URI as the source endpoint.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-source\-ip\-address\fR

Clear existing source IP address.

.TP 2m
\fB\-\-source\-ip\-address\fR=\fISOURCE_IP_ADDRESS\fR

The IP address of the source which can be an external or internal IP.


.RE
.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

This command uses the \fBnetworkmanagement/v1\fR API. The full documentation for
this API can be found at: https://cloud.google.com/



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud beta network\-management connectivity\-tests update
.RE