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

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.
attachmentConfigurationConstraints	object	Output only. [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. [Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands".
constraints	object	Output only. [Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments. (id: InterconnectRemoteLocationConstraints)
continent	string	Output only. [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, EUROPE, NORTH_AMERICA, SOUTH_AMERICA)
creationTimestamp	string	Output only. [Output Only] Creation timestamp inRFC3339 text format.
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#interconnectRemoteLocation for interconnect remote locations. (default: compute#interconnectRemoteLocation)
lacp	string	Output only. [Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED (LACP_SUPPORTED, LACP_UNSUPPORTED)
maxLagSize100Gbps	integer (int32)	Output only. [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. [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.
maxLagSize400Gbps	integer (int32)	Output only. [Output Only] The maximum number of 400 Gbps ports supported in a link aggregation group (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed max_lag_size_400_gbps.
peeringdbFacilityId	string	Output only. [Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).
permittedConnections	array	Output only. [Output Only] Permitted connections.
remoteService	string	Output only. [Output Only] Indicates the service provider present at the remote location. Example values: "Amazon Web Services", "Microsoft Azure".
selfLink	string	Output only. [Output Only] Server-defined URL for the resource.
status	string	Output only. [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. (AVAILABLE, CLOSED)

list

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. [Output Only] Type of resource. Alwayscompute#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 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, interconnectRemoteLocation		Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making alist() request.
list	select	project	orderBy, maxResults, pageToken, filter, 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 alist() request.

SELECT
id,
name,
address,
attachmentConfigurationConstraints,
city,
constraints,
continent,
creationTimestamp,
description,
facilityProvider,
facilityProviderFacilityId,
kind,
lacp,
maxLagSize100Gbps,
maxLagSize10Gbps,
maxLagSize400Gbps,
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 orderBy = '{{ orderBy }}'
AND maxResults = '{{ maxResults }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}'
AND returnPartialSuccess = '{{ returnPartialSuccess }}'
;