REST Resource: interconnectLocations

Resource: InterconnectLocationsGetResponse

Response for the InterconnectLocationsGetRequest.

JSON representation 
{
  "resource": {
    object (InterconnectLocation)
  }
}
Fields
resource

object (InterconnectLocation)

InterconnectLocation

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.

JSON representation 
{
  "kind": string,
  "description": string,
  "selfLink": string,
  "id": string,
  "creationTimestamp": string,
  "name": string,
  "peeringdbFacilityId": string,
  "address": string,
  "facilityProvider": string,
  "facilityProviderFacilityId": string,
  "regionInfos": [
    {
      object (RegionInfo)
    }
  ],
  "crossSiteInterconnectInfos": [
    {
      object (CrossSiteInterconnectInfo)
    }
  ],
  "continent": enum (Continent),
  "city": string,
  "availabilityZone": string,
  "status": enum (Status),
  "supportsPzs": boolean,
  "availableFeatures": [
    enum (InterconnectFeature)
  ],
  "availableLinkTypes": [
    enum (LinkType)
  ],
  "singleRegionProductionCriticalPeerLocations": [
    string
  ]
}
Fields
kind

string

[Output Only] Type of the resource. Always

compute#interconnectLocation

for interconnect locations.
description

string

[Output Only] An optional description of the resource.
id

string (uint64 format)

[Output Only] The unique identifier for the resource. This identifier is defined by the server.
creationTimestamp

string

[Output Only] Creation timestamp in RFC3339 text format.
name

string

[Output Only] Name of the resource.
peeringdbFacilityId

string

[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).
address

string

[Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character.
facilityProvider

string

[Output Only] The name of the provider for this facility (e.g., EQUINIX).
facilityProviderFacilityId

string

[Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1).
regionInfos[]

object (RegionInfo)

[Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Trusted Cloud regions.
crossSiteInterconnectInfos[]

object (CrossSiteInterconnectInfo)

[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.
continent

enum (Continent)

[Output Only] Continent for this location, which can take one of the following values:

  • AFRICA
  • ASIA_PAC
  • EUROPE
  • NORTH_AMERICA
  • SOUTH_AMERICA
city

string

[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands".
availabilityZone

string

[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

enum (Status)

[Output Only] The status of this InterconnectLocation, which can take one of the following values:

  • CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects.
  • AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects.
supportsPzs

boolean

[Output Only] Reserved for future use.
availableFeatures[]

enum (InterconnectFeature)

[Output only] interconnectLocations.list of features available at this InterconnectLocation, which can take one of the following values:

  • IF_MACSEC
singleRegionProductionCriticalPeerLocations[]

string

[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.

RegionInfo

Information about any potential InterconnectAttachments between an Interconnect at a specific InterconnectLocation, and a specific Cloud Region.

JSON representation 
{
  "region": string,
  "expectedRttMs": string,
  "locationPresence": enum (LocationPresence)
}
Fields
region

string

URL for the region of this location.
expectedRttMs

string (int64 format)

Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region.
locationPresence

enum (LocationPresence)

Identifies the network presence of this location.

LocationPresence

Identifies the network presence of this region with respect to the InterconnectLocation. Note that the "LP_" versions of this enum have been deprecated in favor of the unprefixed values.

Enums
LP_GLOBAL [Deprecated] This region is not in any common network presence with this InterconnectLocation.
LP_LOCAL_REGION [Deprecated] This region shares the same regional network presence as this InterconnectLocation.
GLOBAL This region is not in any common network presence with this InterconnectLocation.
LOCAL_REGION This region shares the same regional network presence as this InterconnectLocation.

CrossSiteInterconnectInfo

Information about Cross-Site Interconnect wires which may be created between the containing location and another remote location.

JSON representation 
{
  "city": string
}
Fields
city

string

The remote location for Cross-Site Interconnect wires. This specifies an InterconnectLocation city (metropolitan area designator), which itself may match multiple InterconnectLocations.

Continent

Note that the "C_" versions of this enum have been deprecated in favor of the unprefixed values.

Enums
C_AFRICA
C_ASIA_PAC
C_EUROPE
C_NORTH_AMERICA
C_SOUTH_AMERICA
AFRICA
ASIA_PAC
EUROPE
NORTH_AMERICA
SOUTH_AMERICA

Status

The status of the InterconnectLocation, which determines whether the location may be used to provision new Interconnects.

Enums
CLOSED The InterconnectLocation is closed for provisioning new Interconnects.
AVAILABLE The InterconnectLocation is available for provisioning new Interconnects.

InterconnectFeature

Features that an Interconnect can support.

Enums
IF_MACSEC Media Access Control security (MACsec)
IF_CROSS_SITE_NETWORK Cross-Site Networking

LinkType

Enums

Methods

get

 The method compute.beta.InterconnectLocationsService.Get is not available in Trusted Cloud by S3NS.

list

 The method compute.beta.InterconnectLocationsService.List is not available in Trusted Cloud by S3NS.