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

SYNOPSIS
    gcloud beta 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-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-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="gcp-network"]
        [--source-project=SOURCE_PROJECT] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) 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 beta 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;
      ◆ 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.

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

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

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

NOTES
    This command is currently in beta and might change without notice. This
    variant is also available:

        $ gcloud network-management connectivity-tests create

