NAME

gcloud network-management connectivity-tests create - create a new connectivity test

SYNOPSIS

gcloud network-management connectivity-tests create CONNECTIVITY_TEST (--destination-cloud-sql-instance=DESTINATION_CLOUD_SQL_INSTANCE --destination-gke-master-cluster=DESTINATION_GKE_MASTER_CLUSTER --destination-instance=DESTINATION_INSTANCE --destination-ip-address=DESTINATION_IP_ADDRESS) (--source-app-engine-version=SOURCE_APP_ENGINE_VERSION --source-cloud-function=SOURCE_CLOUD_FUNCTION --source-cloud-run-revision=SOURCE_CLOUD_RUN_REVISION --source-cloud-sql-instance=SOURCE_CLOUD_SQL_INSTANCE --source-gke-master-cluster=SOURCE_GKE_MASTER_CLUSTER --source-instance=SOURCE_INSTANCE --source-ip-address=SOURCE_IP_ADDRESS) [--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] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

Create a new connectivity test with the given name.

EXAMPLES

The following command creates a connectivity test with the name my-test, and the test between a source VM and a destination IP address in a peering network.

$ gcloud network-management connectivity-tests create my-test \ --source-instance=projects/my-project/zones/us-west-1/\ instances/my-instance --destination-ip-address=10.142.0.2 \ --destination-network=projects/my-project/global/networks/\ peering-network

POSITIONAL ARGUMENTS

Connectivity test resource - Name of the connectivity test you want to create.

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.

REQUIRED FLAGS

At least one of these must be specified:
--destination-cloud-sql-instance=DESTINATION_CLOUD_SQL_INSTANCE

A Cloud SQL instance URI as the destination endpoint.

--destination-gke-master-cluster=DESTINATION_GKE_MASTER_CLUSTER

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

--destination-instance=DESTINATION_INSTANCE

A Compute Engine instance URI as the destination endpoint.

--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 least one of these must be specified:
--source-app-engine-version=SOURCE_APP_ENGINE_VERSION

App Engine version URI as the source endpoint.

--source-cloud-function=SOURCE_CLOUD_FUNCTION

A Cloud function URI as the source endpoint.

--source-cloud-run-revision=SOURCE_CLOUD_RUN_REVISION

Cloud Run revision URI as the source endpoint.

--source-cloud-sql-instance=SOURCE_CLOUD_SQL_INSTANCE

A Cloud SQL instance URI as the source endpoint.

--source-gke-master-cluster=SOURCE_GKE_MASTER_CLUSTER

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

--source-instance=SOURCE_INSTANCE

A Compute Engine instance URI as the source endpoint.

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

OPTIONAL 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.

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 create