NAME

gcloud network-management connectivity-tests update - update an existing connectivity test

SYNOPSIS

gcloud network-management connectivity-tests update CONNECTIVITY_TEST [--async] [--description=DESCRIPTION] [--destination-network=DESTINATION_NETWORK] [--destination-port=DESTINATION_PORT] [--destination-project=DESTINATION_PROJECT] [--labels=KEY=VALUE] [--other-projects=[OTHER_PROJECTS,...]] [--protocol=PROTOCOL] [--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-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-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.

$ gcloud network-management connectivity-tests update my-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 arguments in this group but can be set in other ways. To set the project attribute:

provide the argument connectivity_test on the command line with a fully specified name;

set the property core/project;

provide the argument --project on the command line.

This must be specified.

CONNECTIVITY_TEST

ID of the connectivity test or fully qualified identifier for the connectivity test. To set the connectivity_test attribute:

  • provide the argument connectivity_test on the command line.

FLAGS

--async

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

--description=DESCRIPTION

The description of the connectivity test.

--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 or UDP.

--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 and destination project.

--protocol=PROTOCOL

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

--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-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. An IPv6 address is only allowed when the test's destination is a global load balancer VIP.

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. An IPv6 address is only allowed when the test's destination is a global load balancer VIP.

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 the networkmanagement/v1 API. The full documentation for this API can be found at: https://cloud.google.com/

NOTES

This variant is also available:

$ gcloud beta network-management connectivity-tests update