REST Resource: interconnectRemoteLocations

Resource: InterconnectRemoteLocationsGetResponse

Response for the InterconnectRemoteLocationsGetRequest.

JSON representation 
{
  "resource": {
    object (InterconnectRemoteLocation)
  }
}
Fields
resource

object (InterconnectRemoteLocation)

InterconnectRemoteLocation

Represents a Cross-Cloud Interconnect Remote Location resource.

You can use this resource to find remote location details about an Interconnect attachment (VLAN).

JSON representation 
{
  "kind": string,
  "description": string,
  "selfLink": string,
  "id": string,
  "creationTimestamp": string,
  "name": string,
  "peeringdbFacilityId": string,
  "address": string,
  "facilityProvider": string,
  "facilityProviderFacilityId": string,
  "continent": enum (Continent),
  "city": string,
  "status": enum (Status),
  "remoteService": string,
  "permittedConnections": [
    {
      object (PermittedConnections)
    }
  ],
  "constraints": {
    object (Constraints)
  },
  "attachmentConfigurationConstraints": {
    object (ConfigurationConstraints)
  },
  "lacp": enum (Lacp),
  "maxLagSize100Gbps": integer,
  "maxLagSize10Gbps": integer
}
Fields
kind

string

[Output Only] Type of the resource. Always

compute#interconnectRemoteLocation

for interconnect remote locations.
description

string

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

string (uint64 format)

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

string

[Output Only] Creation timestamp in RFC3339 text format.
name

string

[Output Only] Name of the resource.
peeringdbFacilityId

string

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

string

[Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character.
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).
continent

enum (Continent)

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

  • AFRICA
  • ASIA_PAC
  • EUROPE
  • NORTH_AMERICA
  • SOUTH_AMERICA
city

string

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

enum (Status)

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

string

[Output Only] Indicates the service provider present at the remote location. Example values: "Amazon Web Services", "Microsoft Azure".
permittedConnections[]

object (PermittedConnections)

[Output Only] Permitted connections.
constraints

object (Constraints)

[Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments.
attachmentConfigurationConstraints

object (ConfigurationConstraints)

[Output Only] Subset of fields from InterconnectAttachment's |configurationConstraints| field that apply to all attachments for this remote location.
lacp

enum (Lacp)

[Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED
maxLagSize100Gbps

integer

[Output Only] The maximum number of 100 Gbps ports supported in a link aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed maxLagSize100Gbps.
maxLagSize10Gbps

integer

[Output Only] The maximum number of 10 Gbps ports supported in a link aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed maxLagSize10Gbps.

Continent

Enums
AFRICA
ASIA_PAC
EUROPE
NORTH_AMERICA
SOUTH_AMERICA

Status

The status of the InterconnectRemoteLocation, which determines whether the remote location may be used to provision new Cross-Cloud Interconnects.

Enums
CLOSED The InterconnectRemoteLocation is closed for provisioning new Cross-Cloud Interconnects.
AVAILABLE The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects.

PermittedConnections

JSON representation 
{
  "interconnectLocation": string
}
Fields
interconnectLocation

string

[Output Only] URL of an Interconnect location that is permitted to connect to this Interconnect remote location.

Constraints

JSON representation 
{
  "subnetLengthRange": {
    object (SubnetLengthRange)
  },
  "portPairVlan": enum (PortPairVlan),
  "portPairRemoteLocation": enum (PortPairRemoteLocation)
}
Fields
subnetLengthRange

object (SubnetLengthRange)

[Output Only]

[min-length, max-length]

The minimum and maximum value (inclusive) for the IPv4 subnet length.

For example, an interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure requires /30 subnets.

This range specifies the values supported by both cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a remote cloud has no constraint on IPv4 subnet length, the range would thus be {min: 29, max: 30}.
portPairVlan

enum (PortPairVlan)

[Output Only] Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN
portPairRemoteLocation

enum (PortPairRemoteLocation)

[Output Only] Port pair remote location constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, PORT_PAIR_MATCHING_REMOTE_LOCATION.

Trusted Cloud API refers only to individual ports, but the UI uses this field when ordering a pair of ports, to prevent users from accidentally ordering something that is incompatible with their cloud provider. Specifically, when ordering a redundant pair of Cross-Cloud Interconnect ports, and one of them uses a remote location with portPairMatchingRemoteLocation set to matching, the UI requires that both ports use the same remote location.

SubnetLengthRange

JSON representation 
{
  "min": integer,
  "max": integer
}
Fields
min

integer
max

integer

PortPairVlan

Enums
PORT_PAIR_UNCONSTRAINED_VLAN PORT_PAIR_UNCONSTRAINED_VLAN means there is no constraint.
PORT_PAIR_MATCHING_VLAN If PORT_PAIR_MATCHING_VLAN, the Interconnect for this attachment is part of a pair of ports that should have matching VLAN allocations. This occurs with Cross-Cloud Interconnect to Azure remote locations. While GCP's API does not explicitly group pairs of ports, the UI uses this field to ensure matching VLAN ids when configuring a redundant VLAN pair.

PortPairRemoteLocation

Enums
PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION If PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision a redundant pair of Cross-Cloud Interconnects using two different remote locations in the same city.
PORT_PAIR_MATCHING_REMOTE_LOCATION If PORT_PAIR_MATCHING_REMOTE_LOCATION, the remote cloud provider allocates ports in pairs, and the user should choose the same remote location for both ports.

ConfigurationConstraints

JSON representation 
{
  "bgpMd5": enum (BgpMd5),
  "bgpPeerAsnRanges": [
    {
      object (BgpPeerASNRange)
    }
  ]
}
Fields
bgpMd5

enum (BgpMd5)

[Output Only] Whether the attachment's BGP session requires/allows/disallows BGP MD5 authentication. This can take one of the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED.

For example, a Cross-Cloud Interconnect connection to a remote cloud provider that requires BGP MD5 authentication has the interconnectRemoteLocation attachmentConfigurationConstraints.bgp_md5 field set to MD5_REQUIRED, and that property is propagated to the attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is returned if MD5 is requested.
bgpPeerAsnRanges[]

object (BgpPeerASNRange)

[Output Only] interconnectRemoteLocations.list of ASN ranges that the remote location is known to support. Formatted as an array of inclusive ranges {min: min-value, max: max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] allows the peer ASN to be 123 or anything in the range 64512-65534.

This field is only advisory. Although the API accepts other ranges, these are the ranges that we recommend.

BgpMd5

Enums
MD5_OPTIONAL MD5_OPTIONAL: BGP MD5 authentication is supported and can optionally be configured.
MD5_REQUIRED MD5_REQUIRED: BGP MD5 authentication must be configured.
MD5_UNSUPPORTED MD5_UNSUPPORTED: BGP MD5 authentication must not be configured

BgpPeerASNRange

JSON representation 
{
  "min": integer,
  "max": integer
}
Fields
min

integer (uint32 format)
max

integer (uint32 format)

Lacp

Enums
LACP_SUPPORTED LACP_SUPPORTED: LACP is supported, and enabled by default on the Cross-Cloud Interconnect.
LACP_UNSUPPORTED LACP_UNSUPPORTED: LACP is not supported and is not be enabled on this port. GetDiagnostics shows bundleAggregationType as "static". GCP does not support LAGs without LACP, so requestedLinkCount must be 1.

Methods

get

 The method compute.v1.InterconnectRemoteLocationsService.Get is not available in Trusted Cloud by S3NS.

list

 The method compute.v1.InterconnectRemoteLocationsService.List is not available in Trusted Cloud by S3NS.