interconnect_locations

Creates, updates, deletes, gets or lists an interconnect_locations resource.

Overview

Name	interconnect_locations
Type	Resource
Id	google.compute.interconnect_locations

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string (uint64)	Output only. [Output Only] The unique identifier for the resource. This identifier is defined by the server.
name	string	Output only. [Output Only] Name of the resource.
address	string	Output only. [Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character.
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".
availableFeatures	array	[Output only] List of features available at this InterconnectLocation, which can take one of the following values: - IF_MACSEC - IF_CROSS_SITE_NETWORK
availableLinkTypes	array	[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
city	string	[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands".
continent	string	[Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA (AFRICA, ASIA_PAC, C_AFRICA, C_ASIA_PAC, C_EUROPE, C_NORTH_AMERICA, C_SOUTH_AMERICA, EUROPE, NORTH_AMERICA, SOUTH_AMERICA)
creationTimestamp	string	Output only. [Output Only] Creation timestamp inRFC3339 text format.
crossSiteInterconnectInfos	array	[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.
description	string	Output only. [Output Only] An optional description of the resource.
facilityProvider	string	Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX).
facilityProviderFacilityId	string	Output only. [Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1).
kind	string	Output only. [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations. (default: compute#interconnectLocation)
peeringdbFacilityId	string	Output only. [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).
regionInfos	array	Output only. [Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions.
selfLink	string	Output only. [Output Only] Server-defined URL for the resource.
singleRegionProductionCriticalPeerLocations	array	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	string	[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. (AVAILABLE, CLOSED)
supportsPzs	boolean	Output only. [Output Only] Reserved for future use.

list

Name	Datatype	Description
id	string	[Output Only] Unique identifier for the resource; defined by the server.
items	array	A list of InterconnectLocation resources.
kind	string	Output only. [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect locations. (default: compute#interconnectLocationList)
nextPageToken	string	[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
selfLink	string	Output only. [Output Only] Server-defined URL for this resource.
warning	object	[Output Only] Informational warning message.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	project, interconnectLocation		Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request.
list	select	project	maxResults, pageToken, filter, orderBy, returnPartialSuccess	Retrieves the list of interconnect locations available to the specified project.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
interconnectLocation	string
project	string
filter	string
maxResults	integer (uint32)
orderBy	string
pageToken	string
returnPartialSuccess	boolean

SELECT examples

get

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

SELECT
id,
name,
address,
availabilityZone,
availableFeatures,
availableLinkTypes,
city,
continent,
creationTimestamp,
crossSiteInterconnectInfos,
description,
facilityProvider,
facilityProviderFacilityId,
kind,
peeringdbFacilityId,
regionInfos,
selfLink,
singleRegionProductionCriticalPeerLocations,
status,
supportsPzs
FROM google.compute.interconnect_locations
WHERE project = '{{ project }}' -- required
AND interconnectLocation = '{{ interconnectLocation }}' -- required
;

list

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

SELECT
id,
items,
kind,
nextPageToken,
selfLink,
warning
FROM google.compute.interconnect_locations
WHERE project = '{{ project }}' -- required
AND maxResults = '{{ maxResults }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
AND returnPartialSuccess = '{{ returnPartialSuccess }}'
;