gcloud alpha beyondcorp app connections create

NAME
gcloud alpha beyondcorp app connections create - create a new Beyondcorp application connection
SYNOPSIS
gcloud alpha 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
(ALPHA) Create a new Beyondcorp application connection.
EXAMPLES
The following command creates a Connection with ID my-connection using default tcp type connection:
gcloud alpha 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 alpha 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
App 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 app connection or fully qualified identifier for the app 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 (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. This variant is also available:
gcloud beta beyondcorp app connections create