.TH "GCLOUD_COMPUTE_INSTANCES_NETWORK\-INTERFACES_UPDATE" 1



.SH "NAME"
.HP
gcloud compute instances network\-interfaces update \- update a Compute Engine virtual machine network interface



.SH "SYNOPSIS"
.HP
\f5gcloud compute instances network\-interfaces update\fR \fIINSTANCE_NAME\fR [\fB\-\-aliases\fR=\fIALIASES\fR] [\fB\-\-external\-ipv6\-address\fR=\fIEXTERNAL_IPV6_ADDRESS\fR] [\fB\-\-external\-ipv6\-prefix\-length\fR=\fIEXTERNAL_IPV6_PREFIX_LENGTH\fR] [\fB\-\-igmp\-query\fR=\fIIGMP_QUERY\fR] [\fB\-\-internal\-ipv6\-address\fR=\fIINTERNAL_IPV6_ADDRESS\fR] [\fB\-\-internal\-ipv6\-prefix\-length\fR=\fIINTERNAL_IPV6_PREFIX_LENGTH\fR] [\fB\-\-ipv6\-network\-tier\fR=\fIIPV6_NETWORK_TIER\fR] [\fB\-\-network\fR=\fINETWORK\fR] [\fB\-\-network\-interface\fR=\fINETWORK_INTERFACE\fR;\ default="nic0"] [\fB\-\-private\-network\-ip\fR=\fIPRIVATE_NETWORK_IP\fR] [\fB\-\-security\-policy\fR=\fISECURITY_POLICY\fR] [\fB\-\-security\-policy\-region\fR=\fISECURITY_POLICY_REGION\fR] [\fB\-\-stack\-type\fR=\fISTACK_TYPE\fR] [\fB\-\-subnetwork\fR=\fISUBNETWORK\fR] [\fB\-\-zone\fR=\fIZONE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fBgcloud compute instances network\-interfaces update\fR updates network
interfaces of a Compute Engine virtual machine. For example:

.RS 2m
$ gcloud compute instances network\-interfaces update \e
    example\-instance \-\-zone us\-central1\-a \-\-aliases r1:172.16.0.1/32
.RE

sets 172.16.0.1/32 from range r1 of the default interface's subnetwork as the
interface's alias IP.



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIINSTANCE_NAME\fR

Name of the instance to operate on. For details on valid instance names, refer
to the criteria documented under the field 'name' at:
https://cloud.google.com/compute/docs/reference/rest/v1/instances


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-aliases\fR=\fIALIASES\fR

The IP alias ranges to allocate for this interface. If there are multiple IP
alias ranges, they are separated by semicolons.

Can be specified together with \-\-network and/or \-\-subnetwork to choose IP
alias ranges in the new subnetwork. If unspecified, then the previous IP alias
ranges will be allocated in the new subnetwork. If the previous IP alias ranges
are not available in the new subnetwork, then other available IP alias ranges of
the same size will be allocated in the new subnetwork.

For example:

.RS 2m
\-\-aliases="10.128.1.0/24;r1:/32"
.RE

.TP 2m
\fB\-\-external\-ipv6\-address\fR=\fIEXTERNAL_IPV6_ADDRESS\fR

Assigns the given external IPv6 address to an instance. The address must be the
first IP in the range. This option is not applicable to instances with
stack\-type=IPV4_ONLY.

.TP 2m
\fB\-\-external\-ipv6\-prefix\-length\fR=\fIEXTERNAL_IPV6_PREFIX_LENGTH\fR

The prefix length of the external IPv6 address range. This flag should be used
together with \f5\-\-external\-ipv6\-address\fR. Currently only \f5/96\fR is
supported and the default value is \f596\fR.

.TP 2m
\fB\-\-igmp\-query\fR=\fIIGMP_QUERY\fR

Determines if the Compute Engine instance can receive and respond to IGMP query
packets on the specified network interface. \fIIGMP_QUERY\fR must be one of:

.RS 2m
.TP 2m
\fBIGMP_QUERY_DISABLED\fR
IGMP Query on the network interface is disabled.
.TP 2m
\fBIGMP_QUERY_V2\fR
IGMP Query V2 on the network interface is enabled.
.RE
.sp


.TP 2m
\fB\-\-internal\-ipv6\-address\fR=\fIINTERNAL_IPV6_ADDRESS\fR

Assigns the given internal IPv6 address or range to an instance. The address
must be the first IP address in the range or a /96 IP address range. This option
can only be used on a dual stack instance network interface.

.TP 2m
\fB\-\-internal\-ipv6\-prefix\-length\fR=\fIINTERNAL_IPV6_PREFIX_LENGTH\fR

Optional field that indicates the prefix length of the internal IPv6 address
range, should be used together with \f5\-\-internal\-ipv6\-address=fd20::\fR.
Only /96 IP address range is supported and the default value is 96. If not set,
then either the prefix length from \f5\-\-internal\-ipv6\-address=fd20::/96\fR
will be used or the default value of 96 will be assigned.

.TP 2m
\fB\-\-ipv6\-network\-tier\fR=\fIIPV6_NETWORK_TIER\fR

Specifies the IPv6 network tier that will be used to configure the instance
network interface IPv6 access config. \fIIPV6_NETWORK_TIER\fR must be (only one
value is supported):

.RS 2m
.TP 2m
\fBPREMIUM\fR
High quality, Google\-grade network tier.
.RE
.sp


.TP 2m
\fB\-\-network\fR=\fINETWORK\fR

Specifies the network this network interface belongs to.

.TP 2m
\fB\-\-network\-interface\fR=\fINETWORK_INTERFACE\fR; default="nic0"

The name of the network interface to update.

.TP 2m
\fB\-\-private\-network\-ip\fR=\fIPRIVATE_NETWORK_IP\fR

Assign the given IP address to the interface. Can be specified only together
with \-\-network and/or \-\-subnetwork to choose the IP address in the new
subnetwork. If unspecified, then the previous IP address will be allocated in
the new subnetwork. If the previous IP address is not available in the new
subnetwork, then another available IP address will be allocated automatically
from the new subnetwork CIDR range.

.TP 2m
\fB\-\-security\-policy\fR=\fISECURITY_POLICY\fR

The security policy that will be set for this instance network interface. To
remove the policy from this instance network interface set the policy to an
empty string.

.TP 2m
\fB\-\-security\-policy\-region\fR=\fISECURITY_POLICY_REGION\fR

Region of the security policy to operate on. Overrides the default
\fBcompute/region\fR property value for this command invocation.

.TP 2m
\fB\-\-stack\-type\fR=\fISTACK_TYPE\fR

The stack type for the network interface. Determines if IPv6 is enabled on the
network interface. \fISTACK_TYPE\fR must be one of:

.RS 2m
.TP 2m
\fBIPV4_IPV6\fR
The network interface can have both IPv4 and IPv6 addresses.
.TP 2m
\fBIPV4_ONLY\fR
The network interface will be assigned IPv4 addresses.
.TP 2m
\fBIPV6_ONLY\fR
The network interface will be assigned IPv6 addresses.
.RE
.sp


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

Specifies the subnetwork this network interface belongs to.

.TP 2m
\fB\-\-zone\fR=\fIZONE\fR

Zone of the instance to operate on. If not specified, you might be prompted to
select a zone (interactive mode only). \f5gcloud\fR attempts to identify the
appropriate zone by searching for resources in your currently active project. If
the zone cannot be determined, \f5gcloud\fR prompts you for a selection with all
available Google Cloud Platform zones.

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

.RS 2m
$ gcloud config set compute/zone ZONE
.RE

A list of zones can be fetched by running:

.RS 2m
$ gcloud compute zones list
.RE

To unset the property, run:

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

Alternatively, the zone can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_ZONE\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"

These variants are also available:

.RS 2m
$ gcloud alpha compute instances network\-interfaces update
.RE

.RS 2m
$ gcloud beta compute instances network\-interfaces update
.RE