Update port mapping services
This page describes how service producers can update Private Service Connect port mapping services.
Add a network endpoint
You can add network endpoints to a port mapping network endpoint group (NEG) without needing to recreate the NEG.
For information about adding a network endpoint, see Add networking endpoints to a port mapping NEG.
List network endpoints
You can list the network endpoints that are associated with a port mapping NEG.
In the Google Cloud console, go to the Network Endpoint Groups page.
Click the name of your port mapping NEG.
Use the network-endpoint-groups list-network-endpoints
command.
gcloud compute network-endpoint-groups list-network-endpointsNEG \ --region=REGION
Replace the following:
NEG
: the name of the port mapping NEG.REGION
: the region of the port mapping NEG.
Send a POST
request to the
regionNetworkEndpointGroups.listNetworkEndpoints
method.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /regions/REGION /networkEndpointGroups/NEG /listNetworkEndpoints
Replace the following:
PROJECT_ID
: the ID of the port mapping NEG's project.REGION
: the region of the port mapping NEG.NEG
: the name of the port mapping NEG.
Update a network endpoint
If you need to update the port mapping or VM that is associated with a network endpoint, you can remove the network endpoint or delete the VM. When you delete a VM, Google Cloud deletes all network endpoints that are associated with the VM.
After the network endpoint is deleted, add a network endpoint to the port mapping NEG that contains the updated port mapping or VM.
Remove a network endpoint from a port mapping NEG
You can remove network endpoints from a port mapping NEG without needing to recreate the NEG.
In the Google Cloud console, go to the Network Endpoint Groups page.
Click the name of the port mapping NEG that you want to update.
Select the network endpoint that you want to remove.
Click Remove endpoint.
Use the network-endpoint-groups update
command.
gcloud compute network-endpoint-groups updateNEG \ --region=REGION \ --remove-endpoint=instance=https://www.googleapis.com/compute/v1/projects/PROJECT_ID /zones/ZONE /instances/INSTANCE_NAME
Replace the following:
NEG
: the name of the port mapping NEG.REGION
: the region of the port mapping NEG.PROJECT_ID
: the ID of the port mapping NEG's project.ZONE
: the zone of the VM that is associated with the network endpoint to remove.INSTANCE_NAME
: the name of the instance that is associated with the network endpoint to remove.
Send a POST
request to the
regionNetworkEndpointGroups.detachNetworkEndpoints
method.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /regions/REGION /networkEndpointGroups/NEG /detachNetworkEndpoints { "networkEndpoints": [ { "instance": "projects/PROJECT_ID /zones/ZONE /instances/INSTANCE_NAME " } ] }
Replace the following:
PROJECT_ID
: the ID of the port mapping NEG's project.REGION
: the region of the port mapping NEG.NEG
: the name of the port mapping NEG.ZONE
: the zone of the VM that is associated with the network endpoint to remove.INSTANCE_NAME
: the name of the instance that is associated with the network endpoint to remove.