GOgoogle
interconnectLocations

GET /projects/{project}/global/interconnectLocations/{interconnectLocation}

Changed on

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

Request

  • Base URL
    https://compute.googleapis.com/compute/v1
  • URL
    https://compute.googleapis.com/compute/v1/projects/{project}/global/interconnectLocations/{interconnectLocation}
  • Auth
    • OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/cloud-platform
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/cloud-platform
    • or OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/compute
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/compute
    • or OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/compute.readonly
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/compute.readonly

Path parameters

projectstring required

Project ID for this request.

interconnectLocationstring required

Name of the interconnect location to return.

Response

Successful response

addressstring

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

availabilityZonestring

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

availableFeaturesstring[]

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

  • IF_MACSEC
  • IF_CROSS_SITE_NETWORK
availableLinkTypesstring[]

[Output only] 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
citystring

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

continent'AFRICA' | 'ASIA_PAC' | 'C_AFRICA' | 'C_ASIA_PAC' | 'C_EUROPE' | 'C_NORTH_AMERICA' | 'C_SOUTH_AMERICA' | 'EUROPE' | 'NORTH_AMERICA' | 'SOUTH_AMERICA'

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

  • AFRICA
  • ASIA_PAC
  • EUROPE
  • NORTH_AMERICA
  • SOUTH_AMERICA
creationTimestampstring

Output only. [Output Only] Creation timestamp inRFC3339 text format.

descriptionstring

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

facilityProviderstring

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

facilityProviderFacilityIdstring

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

idstring uint64

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

kindstring

Output only. [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations.

namestring

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

peeringdbFacilityIdstring

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

selfLinkstring

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

singleRegionProductionCriticalPeerLocationsstring[]

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

status'AVAILABLE' | 'CLOSED'

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

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

Changes

  • 8b85e897d3dcRevision changes
    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/compute.readonly was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/compute.readonly was removed from the endpoint's security scheme Oauth2c

  • 48929bf89eebRevision changes
    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/compute.readonly was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/compute.readonly was removed from the endpoint's security scheme Oauth2c