NAME

gcloud alpha beyondcorp app legacy connections create - create a new Beyondcorp application legacy connection

SYNOPSIS

gcloud alpha beyondcorp app legacy connections create (CONNECTION : --location=LOCATION) (--application-endpoint=APPLICATION_ENDPOINT | --application-endpoint-host=APPLICATION_ENDPOINT_HOST --application-endpoint-port=APPLICATION_ENDPOINT_PORT) [--async] [--connectors=[CONNECTORS,...]] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] [--type=TYPE; default="TCP_PROXY"] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) Create a new Beyondcorp application legacy connection.

EXAMPLES

The following command creates a legacy Connection with ID my-connection using default tcp type connection:

$ gcloud alpha beyondcorp app legacy connections create \ my-connection --location=us-central1 \ --application-endpoint=localhost:8080

The following command creates a legacy Connection with ID my-connection with explicit project value for all required and optional parameters:

$ gcloud alpha beyondcorp app legacy connections create \ my-connection --project=projectId --location=us-central1 \ --application-endpoint-host=localhost \ --application-endpoint-port=8080 --type=tcp \ --connectors=my-connector1,my-connector2 --labels='foo=bar' \ --display-name=connection-display-name --async

POSITIONAL ARGUMENTS

Connection resource - The Beyondcorp application connection you want to create.

The arguments in this group can be used to specify the attributes of this 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 connection 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.

CONNECTION

ID of the connection or fully qualified identifier for the connection. To set the connection attribute:

  • provide the argument connection on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION

The location of the beyondcorp service.

To set the location attribute:

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

  • provide the argument --location on the command line.

REQUIRED FLAGS

Application endpoint.

Exactly one of these must be specified:

--application-endpoint=APPLICATION_ENDPOINT

Address of the remote application endpoint for the Beyondcorp Connection in form of <host>:<port>.

--application-endpoint-host=APPLICATION_ENDPOINT_HOST

Hostname or IP address of the remote application endpoint.

This flag argument must be specified if any of the other arguments in this group are specified.

--application-endpoint-port=APPLICATION_ENDPOINT_PORT

Port of the remote application endpoint.

This flag argument must be specified if any of the other arguments in this group are specified.

OPTIONAL FLAGS

--async

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

--connectors=[CONNECTORS,...]

List of connectors name that are authorised to be associated with this Connection.

--display-name=DISPLAY_NAME

An arbitrary user-provided name for the connection. Cannot exceed 64 characters.

--labels=[KEY=VALUE,...]

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers. Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.

--type=TYPE; default="TCP_PROXY"

The type of network connnectivity used by the connection. TYPE must be (currently only one value is supported):

tcp

TCP connection

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

NOTES

This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.