1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-18 23:08:48 +00:00

gcloud: Wed Jul 26 10:48:49 UTC 2023

This commit is contained in:
Automated 2023-07-26 10:48:49 +00:00
parent 64e67b443c
commit 4558a00e48
204 changed files with 2787 additions and 1591 deletions

View file

@ -4,10 +4,8 @@ NAME
SYNOPSIS
gcloud beta compute routers nats create NAME --router=ROUTER
(--auto-allocate-nat-external-ips
| --nat-external-ip-pool=IP_ADDRESS,[IP_ADDRESS,...])
(--nat-all-subnet-ip-ranges
| --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...]
| --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|:ALL],[...]
| --nat-primary-subnet-ip-ranges) [--async]
[--auto-network-tier=AUTO_NETWORK_TIER]
[--[no-]enable-dynamic-port-allocation]
@ -19,7 +17,10 @@ SYNOPSIS
[--tcp-established-idle-timeout=TCP_ESTABLISHED_IDLE_TIMEOUT]
[--tcp-time-wait-timeout=TCP_TIME_WAIT_TIMEOUT]
[--tcp-transitory-idle-timeout=TCP_TRANSITORY_IDLE_TIMEOUT]
[--udp-idle-timeout=UDP_IDLE_TIMEOUT] [GCLOUD_WIDE_FLAG ...]
[--type=TYPE] [--udp-idle-timeout=UDP_IDLE_TIMEOUT]
[--auto-allocate-nat-external-ips
| --nat-external-ip-pool=IP_ADDRESS,[IP_ADDRESS,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute routers nats create is used to create a NAT on a
@ -56,24 +57,18 @@ REQUIRED FLAGS
--router=ROUTER
The Router to use for NAT.
Exactly one of these must be specified:
--auto-allocate-nat-external-ips
Automatically allocate external IP addresses for Cloud NAT
--nat-external-ip-pool=IP_ADDRESS,[IP_ADDRESS,...]
External IP Addresses to use for Cloud NAT
Exactly one of these must be specified:
--nat-all-subnet-ip-ranges
Allow all IP ranges of all subnetworks in the region, including
primary and secondary ranges, to use NAT.
--nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...]
--nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|:ALL],[...]
List of subnetwork primary and secondary IP ranges to be allowed to
use NAT.
▸ SUBNETWORK:ALL - specifying a subnetwork name with ALL includes
the primary range and all secondary ranges of the subnet.
▸ SUBNETWORK - including a subnetwork name includes only the
primary subnet range of the subnetwork.
▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary
@ -219,11 +214,30 @@ OPTIONAL FLAGS
https://cloud.google.com/sdk/gcloud/reference/topic/datetimes for
information on duration formats.
--type=TYPE
Type of the NAT Gateway. Defaults to PUBLIC if not specified. TYPE must
be one of:
PRIVATE
Used for private-to-private NAT translations. Allows communication
between VPC Networks.
PUBLIC
Used for private-to-public NAT translations. Allows VMs to
communicate with the Internet.
--udp-idle-timeout=UDP_IDLE_TIMEOUT
Timeout for UDP connections. See
https://cloud.google.com/sdk/gcloud/reference/topic/datetimes for
information on duration formats.
At most one of these can be specified:
--auto-allocate-nat-external-ips
Automatically allocate external IP addresses for Cloud NAT
--nat-external-ip-pool=IP_ADDRESS,[IP_ADDRESS,...]
External IP Addresses to use for Cloud NAT
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,

View file

@ -4,9 +4,10 @@ NAME
SYNOPSIS
gcloud beta compute routers nats rules create RULE_NUMBER --match=MATCH
--nat=NAT --router=ROUTER
--source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...] [--async]
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
--nat=NAT --router=ROUTER [--async] [--region=REGION]
[--source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...]]
[--source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute routers nats rules create is used to create a
@ -28,27 +29,29 @@ POSITIONAL ARGUMENTS
REQUIRED FLAGS
--match=MATCH
CEL Expression used to identify traffic to which this rule applies.
◆ Supported attributes: destination.ip
◆ Supported operators: ||, ==
◆ Supported methods: inIpRange
Examples of allowed Match expressions:
◆ Supported attributes (Public NAT): destination.ip
◆ Supported attributes (Private NAT): nexthop.hub
◆ Supported methods (Public Nat): inIpRange
◆ Supported operators (Public NAT): ||, ==
◆ Supported operators (Private NAT): ==
Examples of allowed Match expressions (Public NAT):
◆ 'inIpRange(destination.ip, "203.0.113.0/24")''
◆ 'destination.ip == "203.0.113.7"'
◆ 'destination.ip == "203.0.113.7" || inIpRange(destination.ip,
"203.0.113.16/25")'
Example of allowed Match expression (Private NAT):
◆ nexthop.hub ==
"//networkconnectivity.googleapis.com/projects/p1/locations/global/hubs/h1"
--nat=NAT
Name of the NAT that contains the Rule
--router=ROUTER
The Router to use for NAT.
--source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...]
External IP Addresses to use for connections matching this rule.
These must be valid reserved external IPs in the same region.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to
@ -74,6 +77,19 @@ OPTIONAL FLAGS
Alternatively, the region can be stored in the environment variable
CLOUDSDK_COMPUTE_REGION.
--source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...]
External IP Addresses to use for connections matching this rule.
These must be valid reserved external IPs in the same region.
--source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...]
Subnetworks from which addresses are used for connections matching this
rule. This is only supported for Private NAT, and is required when
creating a Private NAT gateway.
These must be Subnetwork resources in the same region, with purpose set
to PRIVATE_NAT.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,

View file

@ -6,8 +6,11 @@ SYNOPSIS
gcloud beta compute routers nats rules update RULE_NUMBER --nat=NAT
--router=ROUTER [--async] [--match=MATCH] [--region=REGION]
[--source-nat-active-ips=IP_ADDRESS,[IP_ADDRESS,...]]
[--source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...]]
[--clear-source-nat-drain-ips
| --source-nat-drain-ips=IP_ADDRESS,[IP_ADDRESS,...]]
[--clear-source-nat-drain-ranges
| --source-nat-drain-ranges=SUBNETWORK,[SUBNETWORK,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
@ -41,16 +44,23 @@ OPTIONAL FLAGS
--match=MATCH
CEL Expression used to identify traffic to which this rule applies.
◆ Supported attributes: destination.ip
◆ Supported operators: ||, ==
◆ Supported methods: inIpRange
Examples of allowed Match expressions:
◆ Supported attributes (Public NAT): destination.ip
◆ Supported attributes (Private NAT): nexthop.hub
◆ Supported methods (Public Nat): inIpRange
◆ Supported operators (Public NAT): ||, ==
◆ Supported operators (Private NAT): ==
Examples of allowed Match expressions (Public NAT):
◆ 'inIpRange(destination.ip, "203.0.113.0/24")''
◆ 'destination.ip == "203.0.113.7"'
◆ 'destination.ip == "203.0.113.7" || inIpRange(destination.ip,
"203.0.113.16/25")'
Example of allowed Match expression (Private NAT):
◆ nexthop.hub ==
"//networkconnectivity.googleapis.com/projects/p1/locations/global/hubs/h1"
--region=REGION
Region of the NAT containing the Rule to update. If not specified, you
might be prompted to select a region (interactive mode only).
@ -76,6 +86,14 @@ OPTIONAL FLAGS
These must be valid reserved external IPs in the same region.
--source-nat-active-ranges=SUBNETWORK,[SUBNETWORK,...]
Subnetworks from which addresses are used for connections matching this
rule. This is only supported for Private NAT, and is required when
creating a Private NAT gateway.
These must be Subnetwork resources in the same region, with purpose set
to PRIVATE_NAT.
At most one of these can be specified:
--clear-source-nat-drain-ips
@ -87,6 +105,17 @@ OPTIONAL FLAGS
These must be external IPs previously used as active IPs on this
rule. No new connections will be established using these IPs.
At most one of these can be specified:
--clear-source-nat-drain-ranges
Clear drained ranges from the Rule
--source-nat-drain-ranges=SUBNETWORK,[SUBNETWORK,...]
Subnetwork ranges to drain connections on.
These must be subnetworks previously used as active ranges on this
rule. No new connections will be established using these ranges.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,

View file

@ -23,7 +23,7 @@ SYNOPSIS
| --tcp-transitory-idle-timeout=TCP_TRANSITORY_IDLE_TIMEOUT]
[--clear-udp-idle-timeout | --udp-idle-timeout=UDP_IDLE_TIMEOUT]
[--nat-all-subnet-ip-ranges
| --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...]
| --nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|:ALL],[...]
| --nat-primary-subnet-ip-ranges] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
@ -252,10 +252,12 @@ OPTIONAL FLAGS
Allow all IP ranges of all subnetworks in the region, including
primary and secondary ranges, to use NAT.
--nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME],[...]
--nat-custom-subnet-ip-ranges=SUBNETWORK[:RANGE_NAME|:ALL],[...]
List of subnetwork primary and secondary IP ranges to be allowed to
use NAT.
▸ SUBNETWORK:ALL - specifying a subnetwork name with ALL includes
the primary range and all secondary ranges of the subnet.
▸ SUBNETWORK - including a subnetwork name includes only the
primary subnet range of the subnetwork.
▸ SUBNETWORK:RANGE_NAME - specifying a subnetwork and secondary