APIs and reference
This page describes individual resources that can be used withCloud NAT.
The Cloud NAT APIs andgcloud commands are part ofCompute Engine.
Cloud NAT is configured using newCloud Router commands and parameters.
gcloud CLI commands
Existing Cloud Router commands can be found in theGoogle Cloud CLIinterface documentation.
The following table lists the commonly used Cloud NAT commands:
| Command | Description |
|---|---|
gcloud compute routers nats create | Adds a NAT configuration to a router. |
gcloud compute routers nats update | Updates a NAT configuration on a router. |
gcloud compute routers nats delete | Removes a NAT configuration from a router. |
gcloud compute routers nats list | Lists NAT configurations on a router. |
gcloud compute routers nats describe | Shows a NAT configuration on a router. |
gcloud compute routers get-status | Gets runtime information on the specified Cloud Router, including the status of the NAT. |
gcloud compute routers get-nat-mapping-info | Shows NAT IP:port-ranges. |
gcloud compute routers get-nat-ip-info | Shows NAT IP address usage. |
gcloud compute routers nats rules create | Adds a NAT rule to an existing NAT gateway. |
gcloud compute routers nats rules update | Updates a single NAT rule. |
gcloud compute routers nats rules delete | Deletes a NAT rule from a NAT gateway. |
gcloud compute routers nats rules describe | Describes a NAT rule. |
gcloud compute routers nats rules list | Lists all NAT rules in a NAT gateway. |
Rest API
All NAT operations are performed on theRouter resource. They all requireOAuth 2.0 authentication.
The following table lists the commonly used Cloud Router APIs:
| Command | Description |
|---|---|
routers.insert | Creates a Cloud Router. You can specify a NAT configuration when you create the router. |
routers.update | Updates a Cloud Router. You can specify a NAT configuration when you update the router. |
routers.patch | Patches a Cloud Router. You can specify a NAT configuration when you patch the router. |
routers.getRouterStatus | Gets runtime information on the specified Cloud Router, including the status of the NAT. |
routers.getNatMappingInfo | Retrieves runtime NAT mapping information of VM endpoints. |
routers.getNatIpInfo | Retrieves runtime NAT IP address information for the specified Cloud Router. |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.