- NAME
-
- gcloud alpha compute interconnects attachments dedicated create - create a Compute Engine dedicated interconnect attachment
- SYNOPSIS
-
-
gcloud alpha compute interconnects attachments dedicated create
NAME
--interconnect
=INTERCONNECT
--router
=ROUTER
[--bandwidth
=BANDWIDTH
] [--candidate-ipv6-subnets
=[IPV6_SUBNET
,…]] [--candidate-subnets
=[SUBNET
,…]] [--cloud-router-ipv6-interface-id
=INTERFACE_ID
] [--customer-router-ipv6-interface-id
=PEER_INTERFACE_ID
] [--description
=DESCRIPTION
] [--dry-run
] [--enable-admin
] [--enable-multicast
] [--encryption
=ENCRYPTION
] [--ipsec-internal-addresses
=[ADDRESSES
]] [--mtu
=MTU
] [--region
=REGION
] [--stack-type
=STACK_TYPE
] [--subnet-length
=SUBNET_LENGTH
] [--vlan
=VLAN
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
gcloud alpha compute interconnects attachments dedicated create
is used to create a dedicated 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
-
--interconnect
=INTERCONNECT
- The interconnect for the interconnect attachment
--router
=ROUTER
- The Google Cloud Router to use for dynamic routing.
- 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
--candidate-ipv6-subnets
=[IPV6_SUBNET
,…]-
The
candididate-ipv6-subnets
field is not available. --candidate-subnets
=[SUBNET
,…]-
Up to 16 candidate prefixes that can be used to restrict the allocation of
cloudRouterIpAddress
andcustomerRouterIpAddress
for this attachment. All prefixes must be within link-local address space. Google attempts to select an unused subnet of SUBNET_LENGTH from the supplied candidate subnet(s), or all of link-local space if no subnets supplied. Google does not re-use a subnet already in-use by your project, even if it's contained in one of the candidate subnets. The request fails if all candidate subnets are in use at Google's edge. --cloud-router-ipv6-interface-id
=INTERFACE_ID
-
cloud-router-ipv6-interface-id
field is not available. --customer-router-ipv6-interface-id
=PEER_INTERFACE_ID
-
customer-router-ipv6-interface-id
field is not available. --description
=DESCRIPTION
- Human-readable plain-text description of attachment.
--dry-run
- If supplied, validates the attachment without creating it.
--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.
--enable-multicast
- If supplied, the attachment will be able to carry multicast traffic. If not provided on creation, defaults to disabled. Use --no-enable-multicast to disable it.
--encryption
=ENCRYPTION
-
Indicates the user-supplied encryption option for this interconnect attachment
(VLAN attachment).
Possible values are:
NONE
- This is the default value, which means the interconnect attachment carries unencrypted traffic. VMs can send traffic to or receive traffic from such interconnect attachment.IPSEC
- The interconnect attachment carries only traffic that is encrypted by an IPsec device; for example, an HA VPN gateway or third-party IPsec VPN. VMs cannot directly send traffic to or receive traffic from such an interconnect attachment. To use HA VPN over Cloud Interconnect, the interconnect attachment must be created with this option.ENCRYPTION
must be one of:IPSEC
,NONE
. --ipsec-internal-addresses
=[ADDRESSES
]- List of IP address range names that have been reserved for the interconnect attachment (VLAN attachment). Use this option only for an interconnect attachment that has its encryption option set as IPSEC. Currently only one internal IP address range can be specified for each attachment. When creating an HA VPN gateway for the interconnect attachment, if the attachment is configured to use a regional internal IP address, then the VPN gateway's IP address is allocated from the IP address range specified here. If this field is not specified when creating the interconnect attachment, then when creating any HA VPN gateways for this interconnect attachment, the HA VPN gateway's IP address is allocated from a regional external IP address pool.
--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
property:compute/region
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
--stack-type
=STACK_TYPE
-
Stack type of the protocol(s) enabled on this interconnect attachment.
STACK_TYPE
must be one of:IPV4_IPV6
- Both IPv4 and IPv6 protocols are enabled on this attachment.
IPV4_ONLY
- Only IPv4 protocol is enabled on this attachment.
--subnet-length
=SUBNET_LENGTH
-
Length of the IPv4 subnet mask for this attachment. 29 is the default value,
except for attachments on Cross-Cloud Interconnects whose remote location's
"constraints.subnetLengthRange" field specifies a minimum subnet length of 30.
In that case, the default value is 30. The default value is recommended when
there's no requirement on the subnet length.
SUBNET_LENGTH
must be one of:29
,30
. --vlan
=VLAN
- Desired VLAN for this attachment, in the range 2-4093. If not supplied, Google will automatically select a VLAN.
- 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 interconnects attachments dedicated create
gcloud beta compute interconnects attachments dedicated create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-04 UTC.