NAME

gcloud beta beyondcorp app connections create - create a new Beyondcorp application connection

SYNOPSIS

gcloud beta beyondcorp app 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

(BETA) Create a new Beyondcorp application connection.

EXAMPLES

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

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

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

$ gcloud beta beyondcorp app 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 app_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 names 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/v1 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 alpha beyondcorp app connections create