gcloud network-management connectivity-tests create

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

gcloud network-management connectivity-tests create CONNECTIVITY_TEST (--destination-cloud-sql-instance=DESTINATION_CLOUD_SQL_INSTANCE --destination-forwarding-rule=DESTINATION_FORWARDING_RULE --destination-gke-master-cluster=DESTINATION_GKE_MASTER_CLUSTER --destination-gke-pod=DESTINATION_GKE_POD --destination-instance=DESTINATION_INSTANCE --destination-ip-address=DESTINATION_IP_ADDRESS --destination-redis-cluster=DESTINATION_REDIS_CLUSTER --destination-redis-instance=DESTINATION_REDIS_INSTANCE) (--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-gke-pod=SOURCE_GKE_POD --source-instance=SOURCE_INSTANCE --source-ip-address=SOURCE_IP_ADDRESS) [--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="unspecified"] [--source-project=SOURCE_PROJECT] [GCLOUD_WIDE_FLAG …]

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;
• provide the argument --project on the command line;
• set the property core/project.

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.

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-forwarding-rule=DESTINATION_FORWARDING_RULE

A forwarding rule 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-gke-pod=DESTINATION_GKE_POD

A GKE Pod URI 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.

--destination-redis-cluster=DESTINATION_REDIS_CLUSTER

A Redis cluster URI as the destination endpoint.

--destination-redis-instance=DESTINATION_REDIS_INSTANCE

A Redis instance URI as the destination endpoint.

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-gke-pod=SOURCE_GKE_POD

A GKE Pod URI 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.

--async

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

--bypass-firewall-checks

This boolean controls whether to skip firewall checking.

--description=DESCRIPTION

The description of the connectivity test.

--destination-fqdn=DESTINATION_FQDN

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

--destination-network=DESTINATION_NETWORK

A VPC network URI for the destination endpoint. Used only when the source is an external IP address endpoint, and the destination is an internal IP address endpoint.

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

--round-trip

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.

--source-network=SOURCE_NETWORK

A VPC network URI for the source endpoint. Used according to the source-network-type flag.

--source-network-type=SOURCE_NETWORK_TYPE; default="unspecified"

Type of the network where the source is located. SOURCE_NETWORK_TYPE must be one of:

gcp-network

A VPC network. Should be used for internal IP addresses in VPC networks. The source-network field should be set to the URI of this network. Only endpoints within this network will be considered.

internet

Internet. Should be used for internet-routable external IP addresses or IP addresses for global Google APIs and services.

non-gcp-network

A network outside of Google Cloud (for example, an on-premises network or another cloud provider network). Should be used for internal IP addresses outside of Google Cloud. The source-network field should be set to the URI of the VPC network containing a corresponding Cloud VPN tunnel, Cloud Interconnect VLAN attachment, or a router appliance instance. Only endpoints reachable from the provided VPC network via the routes to networks outside of Google Cloud will be considered.

unspecified

Unspecified. The test will analyze all possible IP address locations. This might take longer and produce inaccurate or ambiguous results, so prefer specifying an explicit network type. The source-project field should be set to the project where the Google Cloud endpoint is located, or where the endpoint outside of Google Cloud should be reachable from (via routes to networks outside of Google Cloud). The project might also be inferred from the Connectivity Test project or other projects referenced in the request.

--source-project=SOURCE_PROJECT

Project ID of the source endpoint.

Run $ gcloud help for details.