Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list()
request.
HTTP request
GET https://compute.googleapis.com/compute/v1/projects/{project}/global/interconnectLocations/{resourceId}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
resourceId |
Name of the interconnect location to return. |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
JSON representation | |
---|---|
{ "description": string, "selfLink": string, "id": string, "creationTimestamp": string, "name": string, "peeringdbFacilityId": string, "address": string, "facilityProvider": string, "facilityProviderFacilityId": string, "regionInfos": [ { "region": string, "expectedRttMs": string, "locationPresence": enum } ], "continent": enum, "city": string, "availabilityZone": string, "status": enum, "kind": string } |
Fields | |
---|---|
description |
[Output Only] An optional description of the resource. |
selfLink |
[Output Only] Server-defined URL for the resource. |
id |
[Output Only] The unique identifier for the resource. This identifier is defined by the server. |
creationTimestamp |
[Output Only] Creation timestamp in RFC3339 text format. |
name |
[Output Only] Name of the resource. |
peeringdbFacilityId |
[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb). |
address |
[Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character. |
facilityProvider |
[Output Only] The name of the provider for this facility (e.g., EQUINIX). |
facilityProviderFacilityId |
[Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1). |
regionInfos[] |
[Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions. |
regionInfos[].region |
URL for the region of this location. |
regionInfos[].expectedRttMs |
Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region. |
regionInfos[].locationPresence |
Identifies the network presence of this location. |
continent |
[Output Only] Continent for this location, which can take one of the following values:
|
city |
[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: "Chicago, IL", "Amsterdam, Netherlands". |
availabilityZone |
[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". |
status |
[Output Only] The status of this InterconnectLocation, which can take one of the following values:
|
kind |
[Output Only] Type of the resource. Always |
Authorization Scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
In addition to any permissions specified on the fields above, authorization requires one or more of the following Google IAM permissions:
compute.interconnectLocations.get