Method: interconnectLocations.get

• HTTP request
• Path parameters
• Request body
• Response body
  • JSON representation
• Authorization Scopes
• IAM Permissions

Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request.

HTTP request

GET https://compute.googleapis.com/compute/v1/projects/{project}/global/interconnectLocations/{resourceId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
project	string Project ID for this request.
resourceId	string Name of the interconnect location to return.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation

{ "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, "kind": string }

Fields
description	string [Output Only] An optional description of the resource.
selfLink	string [Output Only] Server-defined URL for the resource.
id	string (fixed64 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 [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	string URL for the region of this location.
regionInfos[].expectedRttMs	string (int64 format) Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region.
regionInfos[].locationPresence	enum Identifies the network presence of this location.
continent	enum [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 [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.
kind	string [Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations.

Authorization Scopes

Requires one of the following OAuth scopes:

• https://www.googleapis.com/auth/compute
• https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

In addition to any permissions specified on the fields above, authorization requires one or more of the following Google IAM permissions:

• compute.interconnectLocations.get