Returns the interconnectDiagnostics
for the specified interconnect.
HTTP request
GET https://compute.googleapis.com/compute/v1/projects/{project}/global/interconnects/{resourceId}/getDiagnostics
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
resourceId |
Name of the interconnect resource to query. |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
JSON representation | |
---|---|
{ "result": { "macAddress": string, "arpCaches": [ { "macAddress": string, "ipAddress": string } ], "links": [ { "circuitId": string, "googleDemarc": string, "receivingOpticalPower": { "value": number, "state": enum }, "transmittingOpticalPower": { "value": number, "state": enum }, "lacpStatus": { "state": enum, "googleSystemId": string, "neighborSystemId": string }, "arpCaches": [ { "macAddress": string, "ipAddress": string } ] } ] } } |
Fields | |
---|---|
result |
|
result.macAddress |
The MAC address of the Interconnect's bundle interface. |
result.arpCaches[] |
A list of |
result.arpCaches[].macAddress |
The MAC address of this ARP neighbor. |
result.arpCaches[].ipAddress |
The IP address of this ARP neighbor. |
result.links[] |
A list of |
result.links[].circuitId |
The unique ID for this link assigned during turn up by Google. |
result.links[].googleDemarc |
The Demarc address assigned by Google and provided in the LoA. |
result.links[].receivingOpticalPower |
An |
result.links[].receivingOpticalPower.value |
Value of the current receiving or transmitting optical power, read in dBm. Take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links. |
result.links[].receivingOpticalPower.state |
The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include:
|
result.links[].transmittingOpticalPower |
An |
result.links[].transmittingOpticalPower.value |
Value of the current receiving or transmitting optical power, read in dBm. Take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links. |
result.links[].transmittingOpticalPower.state |
The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include:
|
result.links[].lacpStatus |
|
result.links[].lacpStatus.state |
The state of a LACP link, which can take one of the following values:
|
result.links[].lacpStatus.googleSystemId |
System ID of the port on Google’s side of the LACP exchange. |
result.links[].lacpStatus.neighborSystemId |
System ID of the port on the neighbor’s side of the LACP exchange. |
result.links[].arpCaches[] |
A list of |
result.links[].arpCaches[].macAddress |
The MAC address of this ARP neighbor. |
result.links[].arpCaches[].ipAddress |
The IP address of this ARP neighbor. |
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.interconnects.get