REST Resource: interconnectLocations

Resource: InterconnectLocationsGetResponse

Response for the InterconnectLocationsGetRequest.

JSON representation 
{ "resource": { "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 } ], "crossSiteInterconnectInfos": [ { "city": string } ], "continent": enum, "city": string, "availabilityZone": string, "status": enum, "supportsPzs": boolean, "availableFeatures": [ enum ], "availableLinkTypes": [ enum ] } }
Fields
resource

object
resource.kind

string

[Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations.
resource.description

string

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

string

[Output Only] Server-defined URL for the resource.
resource.id

string (uint64 format)

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

string

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

string

[Output Only] Name of the resource.
resource.peeringdbFacilityId

string

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

string

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

string

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

string

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

object

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

string

URL for the region of this location.
resource.regionInfos[].expectedRttMs

string (int64 format)

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

enum

Identifies the network presence of this location.
resource.crossSiteInterconnectInfos[]

object

[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.
resource.crossSiteInterconnectInfos[].city

string

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

enum

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

  • AFRICA
  • ASIA_PAC
  • EUROPE
  • NORTH_AMERICA
  • SOUTH_AMERICA
resource.city

string

[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands".
resource.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".
resource.status

enum

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

boolean

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

enum

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

  • IF_MACSEC
resource.availableLinkTypes[]

enum

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

  • LINK_TYPE_ETHERNET_10G_LR
  • LINK_TYPE_ETHERNET_100G_LR
  • LINK_TYPE_ETHERNET_400G_LR4

Methods

get

 Returns the details for the specified interconnect location.

list

 Retrieves the list of interconnect locations available to the specified project.