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

gcloud: Tue Nov 18 10:53:36 UTC 2025

This commit is contained in:
Automated 2025-11-18 10:53:36 +00:00
parent 4b21ae6795
commit e1ec13485a
380 changed files with 16045 additions and 783 deletions

View file

@ -23,6 +23,9 @@ GROUPS
groups
(BETA) Create or manipulate interconnect attachment groups.
l2-forwarding
(BETA) Create or manipulate dedicated interconnect attachments.
partner
(BETA) Create or manipulate partner interconnect attachments.

View file

@ -0,0 +1,76 @@
NAME
gcloud beta compute interconnects attachments l2-forwarding add-mapping -
add new vlan to ip mapping rule to an L2-forwarding attachment
SYNOPSIS
gcloud beta compute interconnects attachments l2-forwarding add-mapping
NAME --vlan-key=VLAN_KEY [--appliance-ip-address=ADDRESSES]
[--appliance-name=APPLIANCE_NAME]
[--inner-vlan-to-appliance-mappings=[innerApplianceIpAddress=INNERAPPLIANCEIPADDRESS],
[innerVlanTags=INNERVLANTAGS]] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute interconnects attachments l2-forwarding
add-mapping add new vlan to ip mapping rule to an L2-forwarding attachment.
POSITIONAL ARGUMENTS
NAME
Name of the interconnect attachment to patch.
REQUIRED FLAGS
--vlan-key=VLAN_KEY
Desired VLAN key for L2 forwarding mapping for the attachment. If not
supplied, all mappings will be displayed.
OPTIONAL FLAGS
--appliance-ip-address=ADDRESSES
A single IPv4 or IPv6 address used as the destination IP address for
ingress packets that match on a VLAN tag, but do not match a more
specific inner VLAN tag.
--appliance-name=APPLIANCE_NAME
The name of the L2 appliance mapping rule.
--inner-vlan-to-appliance-mappings=[innerApplianceIpAddress=INNERAPPLIANCEIPADDRESS],[innerVlanTags=INNERVLANTAGS]
A list of mapping rules from inner VLAN tags to IP addresses. If the
inner VLAN is not explicitly mapped to an IP address range, the
applianceIpAddress is used.
--region=REGION
Region of the interconnect attachment to patch. 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.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute interconnects attachments l2-forwarding add-mapping
$ gcloud alpha compute interconnects attachments l2-forwarding \
add-mapping

View file

@ -0,0 +1,132 @@
NAME
gcloud beta compute interconnects attachments l2-forwarding create - create
a Compute Engine L2 forwarding interconnect attachment
SYNOPSIS
gcloud beta compute interconnects attachments l2-forwarding create NAME
--geneve-vni=GENEVE_HEADER --interconnect=INTERCONNECT
--network=NETWORK
--tunnel-endpoint-ip-address=TUNNEL_ENDPOINT_IP_ADDRESS
[--bandwidth=BANDWIDTH]
[--default-appliance-ip-address=DEFAULT_APPLIANCE_IP_ADDRESS]
[--description=DESCRIPTION] [--enable-admin] [--mtu=MTU]
[--region=REGION] [--resource-manager-tags=[KEY=VALUE,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute interconnects attachments l2-forwarding create
is used to create a L2 forwarding interconnect attachments. An interconnect
attachment is what binds the underlying connectivity of an interconnect to
a path into and out of the customer's cloud network.
POSITIONAL ARGUMENTS
NAME
Name of the interconnect attachment to create.
REQUIRED FLAGS
--geneve-vni=GENEVE_HEADER
A VNI identier for Geneve header, as defined in
https://datatracker.ietf.org/doc/html/rfc8926, used for L2 forwarding.
--interconnect=INTERCONNECT
The interconnect for the interconnect attachment
--network=NETWORK
The Google Network to use for L2 forwarding.
--tunnel-endpoint-ip-address=TUNNEL_ENDPOINT_IP_ADDRESS
A single IPv4 or IPv6 address. This address will be used as the source
IP address for L2 forwarding packets sent to the appliances, and must
be used as the destination IP address for packets that should be sent
out through this attachment.
OPTIONAL FLAGS
--bandwidth=BANDWIDTH
Provisioned capacity of the attachment. BANDWIDTH must be one of:
50m
50 Mbit/s
100m
100 Mbit/s
200m
200 Mbit/s
300m
300 Mbit/s
400m
400 Mbit/s
500m
500 Mbit/s
1g
1 Gbit/s
2g
2 Gbit/s
5g
5 Gbit/s
10g
10 Gbit/s
20g
20 Gbit/s
50g
50 Gbit/s
100g
100 Gbit/s
--default-appliance-ip-address=DEFAULT_APPLIANCE_IP_ADDRESS
A single IPv4 or IPv6 address used as the default destination IP when
there is no VLAN mapping result found for L2 forwarding. Unset field
indicates the unmatched packet should be dropped.
--description=DESCRIPTION
Human-readable plain-text description of attachment.
--enable-admin
Administrative status of the interconnect attachment. If not provided
on creation, defaults to enabled. When this is enabled, the attachment
is operational and will carry traffic. Use --no-enable-admin to disable
it.
--mtu=MTU
Maximum transmission unit (MTU) is the size of the largest IP packet
passing through this interconnect attachment. Must be one of 1440,
1460, 1500, or 8896. If not specified, the value will default to 1440.
--region=REGION
Region of the interconnect attachment to create. 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.
--resource-manager-tags=[KEY=VALUE,...]
A comma-separated list of Resource Manager tags to apply to the
interconnect.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute interconnects attachments l2-forwarding create
$ gcloud alpha compute interconnects attachments l2-forwarding create

View file

@ -0,0 +1,63 @@
NAME
gcloud beta compute interconnects attachments l2-forwarding
describe-mapping - describe a Compute Engine L2 forwarding interconnect
attachment
SYNOPSIS
gcloud beta compute interconnects attachments l2-forwarding
describe-mapping NAME --vlan-key=VLAN_KEY [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute interconnects attachments l2-forwarding
describe-mapping displays all data associated with Compute Engine
interconnect attachment in a project.
POSITIONAL ARGUMENTS
NAME
Name of the interconnect attachment to describe.
REQUIRED FLAGS
--vlan-key=VLAN_KEY
Desired VLAN key for L2 forwarding mapping for the attachment. If not
supplied, all mappings will be displayed.
OPTIONAL FLAGS
--region=REGION
Region of the interconnect attachment to describe. 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.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute interconnects attachments l2-forwarding \
describe-mapping
$ gcloud alpha compute interconnects attachments l2-forwarding \
describe-mapping

View file

@ -0,0 +1,56 @@
NAME
gcloud beta compute interconnects attachments l2-forwarding - create or
manipulate dedicated interconnect attachments
SYNOPSIS
gcloud beta compute interconnects attachments l2-forwarding COMMAND
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Create or manipulate L2 Forwarding Interconnect attachments.
For more information about about interconnect attachments for L2 Forwaring
Interconnect, see the documentation for L2 Forwarding interconnect
attachments
(https://cloud.google.com/network-connectivity/docs/interconnect/how-to/l2-forwarding/creating-l2-attachments).
See also: Interconnect attachments API
(https://cloud.google.com/compute/docs/reference/rest/v1/interconnectAttachments).
GCLOUD WIDE FLAGS
These flags are available to all commands: --help.
Run $ gcloud help for details.
COMMANDS
COMMAND is one of the following:
add-mapping
(BETA) Add new vlan to ip mapping rule to an L2-forwarding attachment.
create
(BETA) Create a Compute Engine L2 forwarding interconnect attachment.
describe-mapping
(BETA) Describe a Compute Engine L2 forwarding interconnect attachment.
list-mapping
(BETA) List Google Compute Engine interconnect attachments.
remove-mapping
(BETA) Remove vlan to ip mapping rule to an L2-forwarding attachment.
update
(BETA) Update a Compute Engine L2 forwarding interconnect attachment.
update-mapping
(BETA) Update vlan to ip mapping rule to an L2-forwarding attachment.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:
$ gcloud compute interconnects attachments l2-forwarding
$ gcloud alpha compute interconnects attachments l2-forwarding

View file

@ -0,0 +1,110 @@
NAME
gcloud beta compute interconnects attachments l2-forwarding list-mapping -
list Google Compute Engine interconnect attachments
SYNOPSIS
gcloud beta compute interconnects attachments l2-forwarding list-mapping
NAME [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT]
[--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute interconnects attachments l2-forwarding
list-mapping displays all Google Compute Engine interconnect attachments in
a project.
By default, interconnect attachments from all regions are listed. The
results can be narrowed down using a filter: --filter="region:( REGION ...
)".
EXAMPLES
To list all interconnect attachments in a project in table form, run:
$ gcloud beta compute interconnects attachments l2-forwarding \
list-mapping
To list the URIs of all interconnect attachments in a project, run:
$ gcloud beta compute interconnects attachments l2-forwarding \
list-mapping --uri
To list all interconnect attachments in the us-central1 and europe-west1
regions, run:
$ gcloud beta compute interconnects attachments l2-forwarding \
list-mapping --filter="region:( us-central1 europe-west1 )"
POSITIONAL ARGUMENTS
NAME
Name of the interconnect attachment to describe.
FLAGS
--region=REGION
Region of the interconnect attachment to describe. 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.
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filter EXPRESSION to each resource item to be listed.
If the expression evaluates True, then that item is listed. For more
details and examples of filter expressions, run $ gcloud topic filters.
This flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--limit=LIMIT
Maximum number of resources to list. The default is unlimited. This
flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--page-size=PAGE_SIZE
Some services group resource list output into pages. This flag
specifies the maximum number of resources per page. The default is
determined by the service if it supports paging, otherwise it is
unlimited (no paging). Paging may be applied before or after --filter
and --limit depending on the service.
--sort-by=[FIELD,...]
Comma-separated list of resource field key names to sort by. The
default order is ascending. Prefix a field with ``~'' for descending
order on that field. This flag interacts with other flags that are
applied in this order: --flatten, --sort-by, --filter, --limit.
--uri
Print a list of resource URIs instead of the default output, and change
the command output to a list of URIs. If this flag is used with
--format, the formatting is applied on this URI list. To display URIs
alongside other keys instead, use the uri() transform.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute interconnects attachments l2-forwarding list-mapping
$ gcloud alpha compute interconnects attachments l2-forwarding \
list-mapping

View file

@ -0,0 +1,61 @@
NAME
gcloud beta compute interconnects attachments l2-forwarding remove-mapping
- remove vlan to ip mapping rule to an L2-forwarding attachment
SYNOPSIS
gcloud beta compute interconnects attachments l2-forwarding remove-mapping
NAME --vlan-key=VLAN_KEY [--region=REGION] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute interconnects attachments l2-forwarding
remove-mapping remove vlan to ip mapping rule to an L2-forwarding
attachment.
POSITIONAL ARGUMENTS
NAME
Name of the interconnect attachment to create.
REQUIRED FLAGS
--vlan-key=VLAN_KEY
Desired VLAN key for L2 forwarding mapping for the attachment. If not
supplied, all mappings will be displayed.
OPTIONAL FLAGS
--region=REGION
Region of the interconnect attachment to create. 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.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute interconnects attachments l2-forwarding \
remove-mapping
$ gcloud alpha compute interconnects attachments l2-forwarding \
remove-mapping

View file

@ -0,0 +1,143 @@
NAME
gcloud beta compute interconnects attachments l2-forwarding update - update
a Compute Engine L2 forwarding interconnect attachment
SYNOPSIS
gcloud beta compute interconnects attachments l2-forwarding update NAME
[--bandwidth=BANDWIDTH]
[--default-appliance-ip-address=DEFAULT_APPLIANCE_IP_ADDRESS]
[--description=DESCRIPTION] [--enable-admin]
[--geneve-vni=GENEVE_HEADER] [--mtu=MTU] [--region=REGION]
[--update-labels=[KEY=VALUE,...]]
[--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute interconnects attachments l2-forwarding update
is used to update interconnect attachments. An interconnect attachment is
what binds the underlying connectivity of an interconnect to a path into
and out of the customer's cloud network.
POSITIONAL ARGUMENTS
NAME
Name of the interconnect attachment to patch.
FLAGS
--bandwidth=BANDWIDTH
Provisioned capacity of the attachment. BANDWIDTH must be one of:
50m
50 Mbit/s
100m
100 Mbit/s
200m
200 Mbit/s
300m
300 Mbit/s
400m
400 Mbit/s
500m
500 Mbit/s
1g
1 Gbit/s
2g
2 Gbit/s
5g
5 Gbit/s
10g
10 Gbit/s
20g
20 Gbit/s
50g
50 Gbit/s
100g
100 Gbit/s
--default-appliance-ip-address=DEFAULT_APPLIANCE_IP_ADDRESS
A single IPv4 or IPv6 address used as the default destination IP when
there is no VLAN mapping result found for L2 forwarding. Unset field
indicates the unmatched packet should be dropped.
--description=DESCRIPTION
Human-readable plain-text description of attachment.
--enable-admin
Administrative status of the interconnect attachment. If not provided
on creation, defaults to enabled. When this is enabled, the attachment
is operational and will carry traffic. Use --no-enable-admin to disable
it.
--geneve-vni=GENEVE_HEADER
A VNI identier for Geneve header, as defined in
https://datatracker.ietf.org/doc/html/rfc8926, used for L2 forwarding.
--mtu=MTU
Maximum transmission unit (MTU) is the size of the largest IP packet
passing through this interconnect attachment. Must be one of 1440,
1460, 1500, or 8896. If not specified, the value will default to 1440.
--region=REGION
Region of the interconnect attachment to patch. 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.
--update-labels=[KEY=VALUE,...]
List of label KEY=VALUE pairs to update. If a label exists, its value
is modified. Otherwise, a new label is created.
Keys must start with a lowercase character and contain only hyphens
(-), underscores (_), lowercase characters, and numbers. Values must
contain only hyphens (-), underscores (_), lowercase characters, and
numbers.
At most one of these can be specified:
--clear-labels
Remove all labels. If --update-labels is also specified then
--clear-labels is applied first.
For example, to remove all labels:
$ gcloud beta compute interconnects attachments l2-forwarding \
update --clear-labels
To remove all existing labels and create two new labels, foo and baz:
$ gcloud beta compute interconnects attachments l2-forwarding \
update --clear-labels --update-labels foo=bar,baz=qux
--remove-labels=[KEY,...]
List of label keys to remove. If a label does not exist it is
silently ignored. If --update-labels is also specified then
--update-labels is applied first.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute interconnects attachments l2-forwarding update
$ gcloud alpha compute interconnects attachments l2-forwarding update

View file

@ -0,0 +1,78 @@
NAME
gcloud beta compute interconnects attachments l2-forwarding update-mapping
- update vlan to ip mapping rule to an L2-forwarding attachment
SYNOPSIS
gcloud beta compute interconnects attachments l2-forwarding update-mapping
NAME --vlan-key=VLAN_KEY [--appliance-ip-address=ADDRESSES]
[--appliance-name=APPLIANCE_NAME]
[--inner-vlan-to-appliance-mappings=[innerApplianceIpAddress=INNERAPPLIANCEIPADDRESS],
[innerVlanTags=INNERVLANTAGS]] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute interconnects attachments l2-forwarding
update-mapping update vlan to ip mapping rule to an L2-forwarding
attachment.
POSITIONAL ARGUMENTS
NAME
Name of the interconnect attachment to create.
REQUIRED FLAGS
--vlan-key=VLAN_KEY
Desired VLAN key for L2 forwarding mapping for the attachment. If not
supplied, all mappings will be displayed.
OPTIONAL FLAGS
--appliance-ip-address=ADDRESSES
A single IPv4 or IPv6 address used as the destination IP address for
ingress packets that match on a VLAN tag, but do not match a more
specific inner VLAN tag.
--appliance-name=APPLIANCE_NAME
The name of the L2 appliance mapping rule.
--inner-vlan-to-appliance-mappings=[innerApplianceIpAddress=INNERAPPLIANCEIPADDRESS],[innerVlanTags=INNERVLANTAGS]
A list of mapping rules from inner VLAN tags to IP addresses. If the
inner VLAN is not explicitly mapped to an IP address range, the
applianceIpAddress is used.
--region=REGION
Region of the interconnect attachment to create. 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.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute interconnects attachments l2-forwarding \
update-mapping
$ gcloud alpha compute interconnects attachments l2-forwarding \
update-mapping