gcloud beta beyondcorp app connections create

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 IDmy-connection using defaulttcp type connection:
gcloudbetabeyondcorpappconnectionscreatemy-connection--location=us-central1--application-endpoint=localhost:8080
The following command creates a Connection with IDmy-connection with explicit project valuefor all required and optional parameters:
gcloudbetabeyondcorpappconnectionscreatemy-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 tocreate. The arguments in this group can be used to specify the attributes ofthis resource. (NOTE) Some attributes are not given arguments in this group butcan be set in other ways.

To set theproject attribute:

  • provide the argumentconnection on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

CONNECTION
ID of the app connection or fully qualified identifier for the app connection.

To set theapp_connection attribute:

  • provide the argumentconnection on the command line.

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

--location=LOCATION
The location of the beyondcorp service.To set thelocation attribute:
  • provide the argumentconnection on the command line with a fullyspecified 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 formof <host>:<port>.
Or at least one of these can be specified:
--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 groupare 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 groupare 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 thisConnection.
--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, andnumbers. 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 thebeyondcorp/v1 API. The full documentation forthis API can be found at:https://cloud.google.com/
NOTES
This command is currently in beta and might change without notice. This variantis also available:
gcloudalphabeyondcorpappconnectionscreate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-21 UTC.