.TH "GCLOUD_ALPHA_COMPUTE_ROUTERS_ADD\-INTERFACE" 1



.SH "NAME"
.HP
gcloud alpha compute routers add\-interface \- add an interface to a Compute Engine router



.SH "SYNOPSIS"
.HP
\f5gcloud alpha compute routers add\-interface\fR \fINAME\fR \fB\-\-interface\-name\fR=\fIINTERFACE_NAME\fR (\fB\-\-interconnect\-attachment\fR=\fIINTERCONNECT_ATTACHMENT\fR\ \fB\-\-interconnect\-attachment\-region\fR=\fIINTERCONNECT_ATTACHMENT_REGION\fR\ |\ \fB\-\-subnetwork\fR=\fISUBNETWORK\fR\ \fB\-\-subnetwork\-region\fR=\fISUBNETWORK_REGION\fR\ |\ \fB\-\-vpn\-tunnel\fR=\fIVPN_TUNNEL\fR\ \fB\-\-vpn\-tunnel\-region\fR=\fIVPN_TUNNEL_REGION\fR) [\fB\-\-ip\-address\fR=\fIIP_ADDRESS\fR] [\fB\-\-ip\-version\fR=\fIIP_VERSION\fR] [\fB\-\-mask\-length\fR=\fIMASK_LENGTH\fR] [\fB\-\-redundant\-interface\fR=\fIREDUNDANT_INTERFACE\fR] [\fB\-\-region\fR=\fIREGION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR \fBgcloud alpha compute routers add\-interface\fR is used to add
an interface to a Compute Engine router.



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fINAME\fR

Name of the router to update.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-interface\-name\fR=\fIINTERFACE_NAME\fR

The name of the interface being added.

.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m

Interconnect Attachment


.RS 2m
.TP 2m
\fB\-\-interconnect\-attachment\fR=\fIINTERCONNECT_ATTACHMENT\fR

The interconnect attachment of the interface being added.

.TP 2m
\fB\-\-interconnect\-attachment\-region\fR=\fIINTERCONNECT_ATTACHMENT_REGION\fR

Region of the interconnectAttachment to operate on. If not specified it will be
set to the region of the router. Overrides the default \fBcompute/region\fR
property value for this command invocation.

.RE
.sp
.TP 2m

Subnetwork


.RS 2m
.TP 2m
\fB\-\-subnetwork\fR=\fISUBNETWORK\fR

The subnetwork of the interface being added.

.TP 2m
\fB\-\-subnetwork\-region\fR=\fISUBNETWORK_REGION\fR

Region of the subnetwork to operate on. If not specified it will be set to the
region of the router. Overrides the default \fBcompute/region\fR property value
for this command invocation.

.RE
.sp
.TP 2m

VPN Tunnel


.RS 2m
.TP 2m
\fB\-\-vpn\-tunnel\fR=\fIVPN_TUNNEL\fR

The tunnel of the interface being added.

.TP 2m
\fB\-\-vpn\-tunnel\-region\fR=\fIVPN_TUNNEL_REGION\fR

Region of the vpn tunnel to operate on. If not specified it will be set to the
region of the router. Overrides the default \fBcompute/region\fR property value
for this command invocation.


.RE
.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-ip\-address\fR=\fIIP_ADDRESS\fR

The link local (IPv4) or ULA (IPv6) address of the router for this interface.

.TP 2m
\fB\-\-ip\-version\fR=\fIIP_VERSION\fR

IP version of the interface. Possible values are IPV4 and IPV6. Defaults to
IPV4. \fIIP_VERSION\fR must be one of:

.RS 2m
.TP 2m
\fBIPV4\fR
Interface with IPv4\-based BGP.
.TP 2m
\fBIPV6\fR
Interface with IPv6\-based BGP.
.RE
.sp


.TP 2m
\fB\-\-mask\-length\fR=\fIMASK_LENGTH\fR

The subnet mask for the IP range of the interface. The interface IP address and
BGP peer IP address must be selected from the subnet defined by this range.

.TP 2m
\fB\-\-redundant\-interface\fR=\fIREDUNDANT_INTERFACE\fR

The interface that is redundant to the current interface.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Region of the router to update. If not specified, you might be prompted to
select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "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. These variants are also available:

.RS 2m
$ gcloud compute routers add\-interface
.RE

.RS 2m
$ gcloud beta compute routers add\-interface
.RE