# REST Resource: interconnectRemoteLocations

- [Resource: InterconnectRemoteLocationsGetResponse](https://docs.cloud.google.com/compute/docs/reference/rest/beta/interconnectRemoteLocations#InterconnectRemoteLocationsGetResponse)
  - [JSON representation](https://docs.cloud.google.com/compute/docs/reference/rest/beta/interconnectRemoteLocations#InterconnectRemoteLocationsGetResponse.SCHEMA_REPRESENTATION)
    - [JSON representation](https://docs.cloud.google.com/compute/docs/reference/rest/beta/interconnectRemoteLocations#InterconnectRemoteLocationsGetResponse.SCHEMA_REPRESENTATION.resource.SCHEMA_REPRESENTATION)
    - [JSON representation](https://docs.cloud.google.com/compute/docs/reference/rest/beta/interconnectRemoteLocations#InterconnectRemoteLocationsGetResponse.SCHEMA_REPRESENTATION.resource.SCHEMA_REPRESENTATION_1)
    - [JSON representation](https://docs.cloud.google.com/compute/docs/reference/rest/beta/interconnectRemoteLocations#InterconnectRemoteLocationsGetResponse.SCHEMA_REPRESENTATION.resource.SCHEMA_REPRESENTATION_2)
- [Methods](https://docs.cloud.google.com/compute/docs/reference/rest/beta/interconnectRemoteLocations#METHODS_SUMMARY)

## Resource: InterconnectRemoteLocationsGetResponse

Response for the InterconnectRemoteLocationsGetRequest.

| JSON representation |
|---|
| ``` { "resource": { "kind": string, "description": string, "selfLink": string, "id": string, "creationTimestamp": string, "name": string, "peeringdbFacilityId": string, "address": string, "facilityProvider": string, "facilityProviderFacilityId": string, "continent": enum, "city": string, "status": enum, "remoteService": string, "permittedConnections": [ { "interconnectLocation": string } ], "constraints": { "subnetLengthRange": { "min": integer, "max": integer }, "portPairVlan": enum, "portPairRemoteLocation": enum }, "attachmentConfigurationConstraints": { "bgpMd5": enum, "bgpPeerAsnRanges": [ { "min": integer, "max": integer } ] }, "lacp": enum, "maxLagSize100Gbps": integer, "maxLagSize10Gbps": integer, "maxLagSize400Gbps": integer } } ``` |

| Fields ||
|---|---|
| `resource` | `object` |
| `resource.kind` | `string` Output only. Type of the resource. Always `compute#interconnectRemoteLocation` for interconnect remote locations. |
| `resource.description` | `string` Output only. An optional description of the resource. |
| `resource.selfLink` | `string` Output only. Server-defined URL for the resource. |
| `resource.id` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The unique identifier for the resource. This identifier is defined by the server. |
| `resource.creationTimestamp` | `string` Output only. Creation timestamp in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. |
| `resource.name` | `string` Output only. Name of the resource. |
| `resource.peeringdbFacilityId` | `string` Output only. The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). |
| `resource.address` | `string` Output only. The postal address of the Point of Presence, each line in the address is separated by a newline character. |
| `resource.facilityProvider` | `string` Output only. The name of the provider for this facility (e.g., EQUINIX). |
| `resource.facilityProviderFacilityId` | `string` Output only. A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). |
| `resource.continent` | `enum` Output only. Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA <br /> |
| `resource.city` | `string` Output only. Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". |
| `resource.status` | `enum` 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. <br /> |
| `resource.remoteService` | `string` Output only. Indicates the service provider present at the remote location. Example values: "Amazon Web Services", "Microsoft Azure". |
| `resource.permittedConnections[]` | `object` Output only. Permitted connections. |
| `resource.permittedConnections[].interconnectLocation` | `string` Output only. URL of an Interconnect location that is permitted to connect to this Interconnect remote location. |
| `resource.constraints` | `object` Output only. Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments. |
| `resource.constraints.subnetLengthRange` | `object` Output only. \[min-length, max-length\] The minimum and maximum value (inclusive) for the IPv4 subnet length. <br /> 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}. |
| `resource.constraints.subnetLengthRange.min` | `integer` |
| `resource.constraints.subnetLengthRange.max` | `integer` |
| `resource.constraints.portPairVlan` | `enum` Output only. Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN |
| `resource.constraints.portPairRemoteLocation` | `enum` 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. Google 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. |
| `resource.attachmentConfigurationConstraints` | `object` Output only. Subset of fields from InterconnectAttachment's \|configurationConstraints\| field that apply to all attachments for this remote location. |
| `resource.attachmentConfigurationConstraints.bgpMd5` | `enum` 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. |
| `resource.attachmentConfigurationConstraints.bgpPeerAsnRanges[]` | `object` 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. |
| `resource.attachmentConfigurationConstraints.bgpPeerAsnRanges[].min` | `integer (https://developers.google.com/discovery/v1/type-format format)` |
| `resource.attachmentConfigurationConstraints.bgpPeerAsnRanges[].max` | `integer (https://developers.google.com/discovery/v1/type-format format)` |
| `resource.lacp` | `enum` Output only. Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED |
| `resource.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. |
| `resource.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. |
| `resource.maxLagSize400Gbps` | `integer` Output only. The maximum number of 400 Gbps ports supported in a link aggregation group (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed maxLagSize400Gbps. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/compute/docs/reference/rest/beta/interconnectRemoteLocations/get` | Returns the details for the specified interconnect remote location. |
| ### `https://docs.cloud.google.com/compute/docs/reference/rest/beta/interconnectRemoteLocations/list` | Retrieves the list of interconnect remote locations available to the specified project. |