List locations

When you order a Dedicated Interconnect connection, you must specify a colocation facility where your network meets Google's network. In most cases, select a facility that's geographically close to your on-premises network.

To view a list of these facilities in the documentation, see All colocation facilities.

To use the Google Cloud console or Google Cloud CLI to view a list of facilities, see the following steps.

Permissions required for this task

To perform this task, you must have been granted the following permissions or the following Identity and Access Management (IAM) roles.

Permissions

• compute.interconnectLocations.list
• compute.interconnectLocations.get

Roles

• roles/owner
• roles/editor
• roles/compute.networkAdmin

Console

You can view a list of the colocation facilities when you order a Dedicated Interconnect connection. You can filter the locations by city or facility name.

For more information, see Ordering a Dedicated Interconnect connection.

gcloud

List all the colocation facilities:

 gcloud compute interconnects locations list
 

Output:

 NAME             DESCRIPTION                    FACILITY_PROVIDER
 lhr-zone1-832    Equinix London Slough (LD5)    Equinix
 nrt-zone1-599    ComSpace I                     Marubeni Access Solutions Inc.
 nrt-zone2-452    Equinix Tokyo (TY2)            Equinix
  ...
 

Describe a location by providing a name to view the details of a facility, such as their physical address. The following example describes the lhr-zone1-832 location:

 gcloud compute interconnects locations describe lhr-zone1-832
 

Output:

  address: |-
    Equinix
    8 Buckingham Avenue
    SLOUGH
    SL1 4AX
    United Kingdom
  availabilityZone: zone1
  availableFeatures:
  − IF_MACSEC
  availableLinkTypes:
  − LINK_TYPE_ETHERNET_10G_LR
  − LINK_TYPE_ETHERNET_100G_LR
  city: London
  continent: EUROPE
  creationTimestamp: '1969-12-31T16:00:00.000-08:00'
  description: Equinix London Slough (LD5)
  facilityProvider: Equinix
  facilityProviderFacilityId: LD5
  id: '1024'
  kind: compute#interconnectLocation
  name: lhr-zone1-832
  peeringdbFacilityId: '832'
  regionInfos:
    region: https://www.googleapis.com/compute/projects/test-project/regions/europe-west1
  selfLink: https://www.googleapis.com/compute/projects/test-project/global/interconnectLocations/lhr-zone1-832
  status: AVAILABLE
 

What's next

• To create a Dedicated Interconnect connection, see the Dedicated Interconnect provisioning overview.

• To learn more about Cloud Interconnect options, see the Cloud Interconnect overview.

• To help you solve common issues that you might encounter when using Cloud Interconnect, see Troubleshooting.