gcloud alpha compute interconnects create - create a Compute Engine interconnect
gcloud alpha compute interconnects create NAME --interconnect-type=INTERCONNECT_TYPE --link-type=LINK_TYPE --location=LOCATION --requested-link-count=REQUESTED_LINK_COUNT [--admin-enabled] [--customer-name=CUSTOMER_NAME] [--description=DESCRIPTION] [--noc-contact-email=NOC_CONTACT_EMAIL] [--remote-location=REMOTE_LOCATION] [GCLOUD_WIDE_FLAG ...]
(ALPHA) gcloud alpha compute interconnects create is used to create interconnects. An interconnect represents a single specific connection between Google and the customer.
For an example, refer to the EXAMPLES section below.
To create an interconnect of type DEDICATED, run:
$ gcloud alpha compute interconnects create example-interconnect \ --customer-name="Example Customer Name" \ --interconnect-type=DEDICATED \ --link-type=LINK_TYPE_ETHERNET_10G_LR \ --location=example-zone1-1 --requested-link-count=1 \ --noc-contact-email=noc@example.com \ --description="Example interconnect"
To create a Cross-Cloud Interconnect, run:
$ gcloud alpha compute interconnects create \ example-cc-interconnect --interconnect-type=DEDICATED \ --link-type=LINK_TYPE_ETHERNET_100G_LR \ --location=example-zone1-1 --requested-link-count=1 \ --remote-location=example-remote-location \ --noc-contact-email=noc@example.com \ --description="Example Cross-Cloud Interconnect"
- NAME
Name of the interconnect to create.
- --interconnect-type=INTERCONNECT_TYPE
Type of the interconnect. INTERCONNECT_TYPE must be one of:
- DEDICATED
Dedicated private interconnect.
- IT_PRIVATE
Dedicated private interconnect. (Warning: IT_PRIVATE is deprecated, use DEDICATED instead.)
- PARTNER
Partner interconnect. Only available to approved partners.
- --link-type=LINK_TYPE
Type of the link for the interconnect. LINK_TYPE must be one of:
- LINK_TYPE_ETHERNET_100G_LR
100Gbps Ethernet, LR Optics.
- LINK_TYPE_ETHERNET_10G_LR
10Gbps Ethernet, LR Optics.
- --location=LOCATION
The location for the interconnect. The locations can be listed by using the gcloud alpha compute interconnects locations list command to find the appropriate location to use when creating an interconnect.
- --requested-link-count=REQUESTED_LINK_COUNT
Target number of physical links in the link bundle.
- --admin-enabled
Administrative status of the interconnect. If not provided on creation, defaults to enabled. When this is enabled, the interconnect is operational and will carry traffic across any functioning linked interconnect attachments. Use --no-admin-enabled to disable it.
- --customer-name=CUSTOMER_NAME
Customer name to put in the Letter of Authorization as the party authorized to request an interconnect. This field is required for most Interconnects, however it is prohibited when creating a Cross-Cloud Interconnect.
- --description=DESCRIPTION
An optional, textual description for the interconnect.
- --noc-contact-email=NOC_CONTACT_EMAIL
Email address to contact the customer NOC for operations and maintenance notifications regarding this interconnect.
- --remote-location=REMOTE_LOCATION
The remote location for a Cross-Cloud Interconnect. The remote locations can be listed by using the gcloud alpha compute interconnects remote-locations list command to find the appropriate remote location to use when creating a Cross-Cloud Interconnect.
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.
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 create
$ gcloud beta compute interconnects create