gcloud alpha compute network-endpoint-groups update

NAME
gcloud alpha compute network-endpoint-groups update - update a Compute Engine network endpoint group
SYNOPSIS
gcloud alpha compute network-endpoint-groups update NAME ( --add-endpoint =[ client-destination-port = CLIENT-DESTINATION-PORT ], [ fqdn = FQDN ], [ instance = INSTANCE ], [ ip = IP ], [ ipv6 = IPV6 ], [ port = PORT ]     | --remove-endpoint =[ client-destination-port = CLIENT-DESTINATION-PORT ], [ fqdn = FQDN ], [ instance = INSTANCE ], [ ip = IP ], [ ipv6 = IPV6 ], [ port = PORT ]) [ --global     | --region = REGION     | --zone = ZONE ] [ GCLOUD_WIDE_FLAG ]
DESCRIPTION
(ALPHA) Update a Compute Engine network endpoint group.
EXAMPLES
To add two endpoints to a network endpoint group:
 gcloud  
alpha  
compute  
network-endpoint-groups  
update  
my-neg  
 --zone 
 = 
us-central1-a  
 --add-endpoint 
 = 
 instance 
 = 
my-instance1,ip = 
 127 
.0.0.1,port = 
 1234 
  
 --add-endpoint 
 = 
 instance 
 = 
my-instance2 

To remove two endpoints from a network endpoint group:

 gcloud  
alpha  
compute  
network-endpoint-groups  
update  
my-neg  
 --zone 
 = 
us-central1-a  
 --remove-endpoint 
 = 
 instance 
 = 
my-instance1,ip = 
 127 
.0.0.1,port = 
 1234 
  
 --remove-endpoint 
 = 
 instance 
 = 
my-instance2 
POSITIONAL ARGUMENTS
NAME
Name of the network endpoint group to operate on.
REQUIRED FLAGS
These flags can be specified multiple times to add/remove multiple endpoints.

Exactly one of these must be specified:

--add-endpoint =[ client-destination-port = CLIENT-DESTINATION-PORT ],[ fqdn = FQDN ],[ instance = INSTANCE ],[ ip = IP ],[ ipv6 = IPV6 ],[ port = PORT ]
The network endpoint to add to the network endpoint group. Keys used depend on the endpoint type of the NEG.

gce-vm-ip-port

*instance*  
-  
Name  
of  
instance  
 in 
  
same  
zone  
as  
the  
network  
endpoint
group.
The  
VM  
instance  
must  
belong  
to  
the  
network  
/  
subnetwork
associated  
with  
the  
network  
endpoint  
group.  
If  
the  
VM  
instance
is  
deleted,  
 then 
  
any  
network  
endpoint  
group  
that  
has  
a  
reference
to  
it  
is  
updated.
*ip*  
-  
Optional  
IP  
address  
of  
the  
network  
endpoint.  
The  
IP  
address
must  
belong  
to  
a  
VM  
 in 
  
compute  
engine  
 ( 
either  
the  
primary  
IP  
or
as  
part  
of  
an  
aliased  
IP  
range ) 
.  
If  
the  
IP  
address  
is  
not
specified,  
 then 
  
the  
primary  
IP  
address  
 for 
  
the  
VM  
instance  
 in 
the  
network  
that  
the  
network  
endpoint  
group  
belongs  
to  
is
used.
*ipv6*  
-  
Optional  
IPv6  
address  
of  
the  
network  
endpoint.  
The  
IPv6
address  
must  
belong  
to  
a  
VM  
 in 
  
compute  
engine  
 ( 
either  
the  
internal
or  
external  
IPv6  
address ) 
.
*port*  
-  
Required  
endpoint  
port  
unless  
NEG  
default  
port  
is  
set.
*client-destination-port*  
-  
Required  
endpoint  
client  
destination  
port  
only  
 for 
  
the  
port
mapping  
NEG.

internet-ip-port

*ip*  
-  
Required  
IPv4  
address  
of  
the  
endpoint  
to  
attach.  
Must  
be
publicly  
routable.
*port*  
-  
Optional  
port  
of  
the  
endpoint  
to  
attach.  
If  
unspecified,
the  
NEG  
default  
port  
is  
set.  
If  
no  
default  
port  
is  
set,  
the
well-known  
port  
 for 
  
the  
backend  
protocol  
is  
used  
instead ( 
 80 
  
 for 
  
HTTP,  
 443 
  
 for 
  
HTTPS ) 
.

internet-fqdn-port

*fqdn*  
-  
Required  
fully  
qualified  
domain  
name  
to  
use  
to  
look  
up  
an
external  
endpoint.  
Must  
be  
resolvable  
to  
a  
public  
IP  
address  
via
public  
DNS.
*port*  
-  
Optional  
port  
of  
the  
endpoint  
to  
attach.  
If  
unspecified,
the  
NEG  
default  
port  
is  
set.  
If  
no  
default  
port  
is  
set,  
the
well-known  
port  
 for 
  
the  
backend  
protocol  
is  
used  
instead ( 
 80 
  
 for 
  
HTTP,  
 443 
  
 for 
  
HTTPS  
or  
HTTP2 ) 
.
Example:  
 ` 
--add-endpoint = 
 "fqdn=backend.example.com,port=443" 
 ` 

non-gcp-private-ip-port

*ip*  
-  
Required  
IPv4  
address  
of  
the  
network  
endpoint  
to  
attach.
The  
IP  
address  
must  
belong  
to  
a  
VM  
not  
 in 
  
Compute  
Engine  
and  
must
be  
routable  
using  
a  
Cloud  
Router  
over  
VPN  
or  
an  
Interconnect
connection.
*port*  
-  
Required  
port  
of  
the  
network  
endpoint  
to  
attach  
unless
the  
NEG  
default  
port  
is  
set.

gce-vm-ip

*instance*  
-  
Required  
instance  
name  
 in 
  
same  
zone  
as  
the  
network
endpoint  
group.
The  
VM  
instance  
must  
belong  
to  
the  
network  
/  
subnetwork
associated  
with  
the  
network  
endpoint  
group.  
If  
the  
VM  
instance
is  
deleted,  
 then 
  
any  
network  
endpoint  
group  
that  
has  
a  
reference
to  
it  
is  
updated.
*ip*  
-  
Optional  
IP  
address  
of  
the  
network  
endpoint  
to  
attach.  
The
IP  
address  
must  
be  
the  
VM ' 
s  
network  
interface  
address.  
If  
not
specified,  
the  
primary  
NIC  
address  
is  
used.
--remove-endpoint =[ client-destination-port = CLIENT-DESTINATION-PORT ],[ fqdn = FQDN ],[ instance = INSTANCE ],[ ip = IP ],[ ipv6 = IPV6 ],[ port = PORT ]
The network endpoint to detach from the network endpoint group. Keys used depend on the endpoint type of the NEG.

gce-vm-ip-port

*instance*  
-  
Required  
name  
of  
instance  
whose  
endpoint ( 
s ) 
  
to
detach.  
If  
the  
IP  
address  
is  
unset,  
all  
endpoints  
 for 
  
the
instance  
 in 
  
the  
NEG  
are  
detached.
*ip*  
-  
Optional  
IPv4  
address  
of  
the  
network  
endpoint  
to  
detach.
If  
specified  
port  
must  
be  
provided  
as  
well.
*ipv6*  
-  
Optional  
IPv6  
address  
of  
the  
network  
endpoint  
to  
detach.
If  
specified  
port  
must  
be  
provided  
as  
well.
*port*  
-  
Optional  
port  
of  
the  
network  
endpoint  
to  
detach.
*client-destination-port*  
-  
Optional  
client  
destination  
port,  
only  
 for 
  
port  
mapping  
NEGs.

internet-ip-port

*ip*  
-  
Required  
IPv4  
address  
of  
the  
network  
endpoint  
to  
detach.
*port*  
-  
Optional  
port  
of  
the  
network  
endpoint  
to  
detach  
 if 
  
the
endpoint  
has  
a  
port  
specified.

internet-fqdn-port

*fqdn*  
-  
Required  
fully  
qualified  
domain  
name  
of  
the  
endpoint  
to
detach.
*port*  
-  
Optional  
port  
of  
the  
network  
endpoint  
to  
detach  
 if 
  
the
endpoint  
has  
a  
port  
specified.

non-gcp-private-ip-port

*ip*  
-  
Required  
IPv4  
address  
of  
the  
network  
endpoint  
to  
detach.
*port*  
-  
Required  
port  
of  
the  
network  
endpoint  
to  
detach  
unless
NEG  
default  
port  
is  
set.

gce-vm-ip

*instance*  
-  
Required  
name  
of  
instance  
with  
endpoints  
to
detach.  
If  
the  
IP  
address  
is  
unset,  
all  
endpoints  
 for 
  
the
instance  
 in 
  
the  
NEG  
are  
detached.
*ip*  
-  
Optional  
IP  
address  
of  
the  
network  
endpoint  
to  
attach.  
The
IP  
address  
must  
be  
the  
VM 's network interface' 
s  
primary  
IP
address.  
If  
not  
specified,  
the  
primary  
NIC  
address  
is  
used.
OPTIONAL FLAGS
At most one of these can be specified:
--global
If set, the network endpoint group is global.
--region = REGION
Region of the network endpoint group to operate on. 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 compute/region property:

  gcloud  
config  
 set 
 
  
compute/region  
REGION 

A list of regions can be fetched by running:

  gcloud  
compute  
regions  
list 
 

To unset the property, run:

  gcloud  
config  
 unset 
 
  
compute/region 

Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION .

--zone = ZONE
Zone of the network endpoint group to operate on. If not specified and the compute/zone property isn't set, you might be prompted to select a zone (interactive mode only).

To avoid prompting when this flag is omitted, you can set the compute/zone property:

  gcloud  
config  
 set 
 
  
compute/zone  
ZONE 

A list of zones can be fetched by running:

  gcloud  
compute  
zones  
list 
 

To unset the property, run:

  gcloud  
config  
 unset 
 
  
compute/zone 

Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE .

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.

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:
  gcloud  
compute  
network-endpoint-groups  
update 
 
  gcloud  
beta  
compute  
network-endpoint-groups  
update 
 
  gcloud  
preview  
compute  
network-endpoint-groups  
update 
 
Design a Mobile Site
View Site in Mobile | Classic
Share by: