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
      }
    ],
    "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.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

Methods

get

Returns the details for the specified interconnect location.

list

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