interconnect_remote_locations

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

Overview

Name	interconnect_remote_locations
Type	Resource
Id	google.compute.interconnect_remote_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.
attachmentConfigurationConstraints	object	[Output Only] Subset of fields from InterconnectAttachment's |configurationConstraints| field that apply to all attachments for this remote location. (id: InterconnectAttachmentConfigurationConstraints)
city	string	[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands".
constraints	object	[Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments. (id: InterconnectRemoteLocationConstraints)
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#interconnectRemoteLocation for interconnect remote locations. (default: compute#interconnectRemoteLocation)
lacp	string	[Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED
maxLagSize100Gbps	integer (int32)	[Output Only] The maximum number of 100 Gbps ports supported in a link aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed max_lag_size_100_gbps.
maxLagSize10Gbps	integer (int32)	[Output Only] The maximum number of 10 Gbps ports supported in a link aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed max_lag_size_10_gbps.
peeringdbFacilityId	string	[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).
permittedConnections	array	[Output Only] Permitted connections.
remoteService	string	[Output Only] Indicates the service provider present at the remote location. Example values: "Amazon Web Services", "Microsoft Azure".
selfLink	string	[Output Only] Server-defined URL for the resource.
status	string	[Output Only] The status of this InterconnectRemoteLocation, which can take one of the following values: - CLOSED: The InterconnectRemoteLocation is closed and is unavailable for provisioning new Cross-Cloud Interconnects. - AVAILABLE: The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects.

list

Successful response

Name	Datatype	Description
id	string	[Output Only] Unique identifier for the resource; defined by the server.
items	array	A list of InterconnectRemoteLocation resources.
kind	string	[Output Only] Type of resource. Always compute#interconnectRemoteLocationList for lists of interconnect remote locations. (default: compute#interconnectRemoteLocationList)
nextPageToken	string	[Output Only] This token lets you 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, interconnectRemoteLocation		Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making a list() request.
list	select	project	filter, maxResults, orderBy, pageToken, returnPartialSuccess	Retrieves the list of interconnect remote 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
interconnectRemoteLocation	string
project	string
filter	string
maxResults	integer (uint32)
orderBy	string
pageToken	string
returnPartialSuccess	boolean

SELECT examples

get

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

SELECT
id,
name,
address,
attachmentConfigurationConstraints,
city,
constraints,
continent,
creationTimestamp,
description,
facilityProvider,
facilityProviderFacilityId,
kind,
lacp,
maxLagSize100Gbps,
maxLagSize10Gbps,
peeringdbFacilityId,
permittedConnections,
remoteService,
selfLink,
status
FROM google.compute.interconnect_remote_locations
WHERE project = '{{ project }}' -- required
AND interconnectRemoteLocation = '{{ interconnectRemoteLocation }}' -- required;

list

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

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