Method: interconnectLocations.get
Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making alist() request.
HTTP request
GET https://compute.googleapis.com/compute/beta/projects/{project}/global/interconnectLocations/{interconnectLocation}
The URL usesgRPC Transcoding syntax. To know more about valid error responses that can be thrown by this HTTP request, please refer to theservice error catalog
Path parameters
| Parameters | |
|---|---|
project |
Project ID for this request. |
interconnectLocation |
Name of the interconnect location to return. |
Request body
The request body must be empty.
Response body
Represents an Interconnect Attachment (VLAN) Location resource.
You can use this resource to find location details about an Interconnect attachment (VLAN). For more information about interconnect attachments, read Creating VLAN Attachments.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{"kind":string,"description":string,"selfLink":string,"id":string,"creationTimestamp":string,"name":string,"peeringdbFacilityId":string,"address":string,"facilityProvider":string,"facilityProviderFacilityId":string,"regionInfos":[{"region":string,"expectedRttMs":string,"locationPresence":enum,"l2ForwardingEnabled":boolean}],"crossSiteInterconnectInfos":[{"city":string}],"continent":enum,"city":string,"availabilityZone":string,"status":enum,"supportsPzs":boolean,"availableFeatures":[enum],"availableLinkTypes":[enum],"singleRegionProductionCriticalPeerLocations":[string]} |
| Fields | |
|---|---|
kind |
[Output Only] Type of the resource. Always |
description |
[Output Only] An optional description of the resource. |
selfLink |
[Output Only] Server-defined URL for the resource. |
id |
[Output Only] The unique identifier for the resource. This identifier is defined by the server. |
creationTimestamp |
[Output Only] Creation timestamp inRFC3339 text format. |
name |
[Output Only] Name of the resource. |
peeringdbFacilityId |
[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). |
address |
[Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. |
facilityProvider |
[Output Only] The name of the provider for this facility (e.g., EQUINIX). |
facilityProviderFacilityId |
[Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). |
regionInfos[] |
[Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions. |
regionInfos[].region |
URL for the region of this location. |
regionInfos[].expectedRttMs |
Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region. |
regionInfos[].locationPresence |
Identifies the network presence of this location. |
regionInfos[].l2ForwardingEnabled |
Identifies whether L2 Interconnect Attachments can be created in this region for interconnects that are in this location. |
crossSiteInterconnectInfos[] |
[Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo objects, that describe where Cross-Site Interconnect wires may connect to from this location and associated connection parameters. Cross-Site Interconnect isn't allowed to locations which are not listed. |
crossSiteInterconnectInfos[].city |
The remote location for Cross-Site Interconnect wires. This specifies an InterconnectLocation city (metropolitan area designator), which itself may match multiple InterconnectLocations. |
continent |
[Output Only] Continent for this location, which can take one of the following values:
|
city |
[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". |
availabilityZone |
[Output Only] Availability zone for this InterconnectLocation. Within a metropolitan area (metro), maintenance will not be simultaneously scheduled in more than one availability zone. Example: "zone1" or "zone2". |
status |
[Output Only] The status of this InterconnectLocation, which can take one of the following values:
|
supportsPzs |
[Output Only] Reserved for future use. |
availableFeatures[] |
[Output only] interconnectLocations.list of features available at this InterconnectLocation, which can take one of the following values:
|
availableLinkTypes[] |
[Output only] interconnectLocations.list of link types available at this InterconnectLocation, which can take one of the following values:
|
singleRegionProductionCriticalPeerLocations[] |
[Output Only] URLs of the other locations that can pair up with this location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% peer locations of each other. |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/compute.readonlyhttps://www.googleapis.com/auth/computehttps://www.googleapis.com/auth/cloud-platform
For more information, see theAuthentication Overview.
IAM Permissions
In addition to any permissions specified on the fields above, authorization requires one or more of the followingIAM permissions:
compute.interconnectLocations.get
To find predefined roles that contain those permissions, seeCompute Engine IAM Roles.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-10-30 UTC.