.TH "GCLOUD_NETWORK\-CONNECTIVITY_INTERNAL\-RANGES_UPDATE" 1



.SH "NAME"
.HP
gcloud network\-connectivity internal\-ranges update \- update an internal range



.SH "SYNOPSIS"
.HP
\f5gcloud network\-connectivity internal\-ranges update\fR (\fIINTERNAL_RANGE\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-clear\-labels\fR\ |\ \fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-clear\-overlaps\fR\ |\ \fB\-\-overlaps\fR=[\fIOVERLAPS\fR,...]] [\fB\-\-ip\-cidr\-range\fR=\fIIP_CIDR_RANGE\fR\ |\ \fB\-\-prefix\-length\fR=\fIPREFIX_LENGTH\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update the details of an internal range.



.SH "EXAMPLES"

Update ip\-cidr\-range of an internal range named \f5\fImy\-range\fR\fR:

.RS 2m
$ gcloud network\-connectivity internal\-ranges update my\-range \e
    \-\-ip\-cidr\-range="192.168.0.0/24"
.RE

Extend an internal range named \f5\fImy\-range\fR\fR to an address block of /24:

.RS 2m
$ gcloud network\-connectivity internal\-ranges update my\-range \e
    \-\-prefix\-length=24
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Internal range resource \- Name of the internal range to be created. 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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5internal_range\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIINTERNAL_RANGE\fR

ID of the internal range or fully qualified identifier for the internal range.

To set the \f5internal_range\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5internal_range\fR on the command line.
.RE
.sp

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

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

The location ID.


To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5internal_range\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line;
.IP "\(bu" 2m
use default global location .
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

Description of the Internal Range

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-labels\fR

Clear existing labels for the range.

.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs for the range being updated.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-clear\-overlaps\fR

Clear existing overlap fields for the range.

.TP 2m
\fB\-\-overlaps\fR=[\fIOVERLAPS\fR,...]

Overlap specifications for the range being updated. \fIOVERLAPS\fR must be one
of:

.RS 2m
.TP 2m
\fBoverlap\-existing\-subnet\-range\fR
Allows for creation of internal ranges that overlap with existing subnets.

.TP 2m
\fBoverlap\-route\-range\fR
Allows for creation or existence of routes that have a more specific destination
than the created range.

.RE
.sp


.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-ip\-cidr\-range\fR=\fIIP_CIDR_RANGE\fR

IP range that this internal range defines.

.TP 2m
\fB\-\-prefix\-length\fR=\fIPREFIX_LENGTH\fR

An alternative to ip\-cidr\-range. Can be set when trying to create a
reservation that automatically finds a free range of the given size.


.RE
.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 "API REFERENCE"

This command uses the \fBnetworkconnectivity/v1\fR API. The full documentation
for this API can be found at:
https://cloud.google.com/network\-connectivity/docs/reference/networkconnectivity/rest



.SH "NOTES"

This variant is also available:

.RS 2m
$ gcloud alpha network\-connectivity internal\-ranges update
.RE