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

Successful response

Name	Datatype	Description
id	string (uint64)	[Output Only] The unique identifier for the resource. This identifier is defined by the server.
name	string	[Output Only] Name of the resource.
address	string	[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
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
creationTimestamp	string	[Output Only] Creation timestamp in RFC3339 text format.
description	string	[Output Only] An optional description of the resource.
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).
kind	string	[Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations. (default: compute#interconnectLocation)
peeringdbFacilityId	string	[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).
regionInfos	array	[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] Server-defined URL for the resource.
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.
supportsPzs	boolean	[Output Only] Reserved for future use.

list

Successful response

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] Type of resource. Always compute#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 than maxResults, 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] 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	filter, maxResults, orderBy, pageToken, 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,
description,
facilityProvider,
facilityProviderFacilityId,
kind,
peeringdbFacilityId,
regionInfos,
selfLink,
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 filter = '{{ filter }}'
AND maxResults = '{{ maxResults }}'
AND orderBy = '{{ orderBy }}'
AND pageToken = '{{ pageToken }}'
AND returnPartialSuccess = '{{ returnPartialSuccess }}';