Returns the interconnectStatuses
for the specified InterconnectGroup.
GET https://compute.googleapis.com/compute/v1/projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus
The URL uses gRPC Transcoding syntax.
Path parameters Parametersproject
string
Project ID for this request.
interconnectGroup
string
Name of the interconnectGroup resource to query.
Request bodyThe request body must be empty.
Response bodyResponse for the InterconnectGroupsGetOperationalStatusResponse.
If successful, the response body contains data with the following structure:
JSON representation{ "result": { "groupStatus": enum, "interconnectStatuses": [ { "interconnect": string, "isActive": enum, "adminEnabled": boolean, "diagnostics": { "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 }, "operationalStatus": enum, "arpCaches": [ { "macAddress": string, "ipAddress": string } ], "macsec": { "operational": boolean, "ckn": string } } ], "bundleOperationalStatus": enum, "bundleAggregationType": enum } } ], "intent": { "topologyCapability": enum }, "configured": { "topologyCapability": { "supportedSla": enum, "intendedCapabilityBlockers": [ { "blockerType": enum, "explanation": string, "documentationLink": string, "metros": [ string ], "facilities": [ string ], "zones": [ string ], "interconnects": [ string ] } ] } }, "operational": { "topologyCapability": { "supportedSla": enum, "intendedCapabilityBlockers": [ { "blockerType": enum, "explanation": string, "documentationLink": string, "metros": [ string ], "facilities": [ string ], "zones": [ string ], "interconnects": [ string ] } ] } } }, "etag": string }Fields
result
object
result.groupStatus
enum
Summarizes the status of the group.
result.interconnectStatuses[]
object
result.interconnectStatuses[].interconnect
string
The URL of the Interconnect being described.
result.interconnectStatuses[].isActive
enum
Whether this interconnect is participating in the redundant configuration.
result.interconnectStatuses[].adminEnabled
boolean
Whether the Interconnect is enabled.
result.interconnectStatuses[].diagnostics
object
The diagnostics of the Interconnect, as returned by the existing get-diagnostics method.
result.interconnectStatuses[].diagnostics.macAddress
string
The MAC address of the Interconnect's bundle interface.
result.interconnectStatuses[].diagnostics.arpCaches[]
object
A list of InterconnectDiagnostics.ARPEntry
objects, describing individual neighbors currently seen by the Google router in the ARP cache for the Interconnect. This will be empty when the Interconnect is not bundled.
result.interconnectStatuses[].diagnostics.arpCaches[].macAddress
string
The MAC address of this ARP neighbor.
result.interconnectStatuses[].diagnostics.arpCaches[].ipAddress
string
The IP address of this ARP neighbor.
result.interconnectStatuses[].diagnostics.links[]
object
A list of InterconnectDiagnostics.LinkStatus
objects, describing the status for each link on the Interconnect.
result.interconnectStatuses[].diagnostics.links[].circuitId
string
The unique ID for this link assigned during turn up by Google.
result.interconnectStatuses[].diagnostics.links[].googleDemarc
string
The Demarc address assigned by Google and provided in the LoA.
result.interconnectStatuses[].diagnostics.links[].receivingOpticalPower
object
An InterconnectDiagnostics.LinkOpticalPower
object, describing the current value and status of the received light level.
result.interconnectStatuses[].diagnostics.links[].receivingOpticalPower.value
number
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.interconnectStatuses[].diagnostics.links[].receivingOpticalPower.state
enum
The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include:
OK
: The value has not crossed a warning threshold.LOW_WARNING
: The value has crossed below the low warning threshold.HIGH_WARNING
: The value has crossed above the high warning threshold.LOW_ALARM
: The value has crossed below the low alarm threshold.HIGH_ALARM
: The value has crossed above the high alarm threshold.result.interconnectStatuses[].diagnostics.links[].transmittingOpticalPower
object
An InterconnectDiagnostics.LinkOpticalPower
object, describing the current value and status of the transmitted light level.
result.interconnectStatuses[].diagnostics.links[].transmittingOpticalPower.value
number
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.interconnectStatuses[].diagnostics.links[].transmittingOpticalPower.state
enum
The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include:
OK
: The value has not crossed a warning threshold.LOW_WARNING
: The value has crossed below the low warning threshold.HIGH_WARNING
: The value has crossed above the high warning threshold.LOW_ALARM
: The value has crossed below the low alarm threshold.HIGH_ALARM
: The value has crossed above the high alarm threshold.result.interconnectStatuses[].diagnostics.links[].lacpStatus
object
result.interconnectStatuses[].diagnostics.links[].lacpStatus.state
enum
The state of a LACP link, which can take one of the following values:
result.interconnectStatuses[].diagnostics.links[].lacpStatus.googleSystemId
string
System ID of the port on Google's side of the LACP exchange.
result.interconnectStatuses[].diagnostics.links[].lacpStatus.neighborSystemId
string
System ID of the port on the neighbor's side of the LACP exchange.
result.interconnectStatuses[].diagnostics.links[].operationalStatus
enum
The operational status of the link.
result.interconnectStatuses[].diagnostics.links[].arpCaches[]
object
A list of InterconnectDiagnostics.ARPEntry
objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled
result.interconnectStatuses[].diagnostics.links[].arpCaches[].macAddress
string
The MAC address of this ARP neighbor.
result.interconnectStatuses[].diagnostics.links[].arpCaches[].ipAddress
string
The IP address of this ARP neighbor.
result.interconnectStatuses[].diagnostics.links[].macsec
object
Describes the status of MACsec encryption on this link.
result.interconnectStatuses[].diagnostics.links[].macsec.operational
boolean
Indicates whether or not MACsec is operational on this link.
result.interconnectStatuses[].diagnostics.links[].macsec.ckn
string
Indicates the Connectivity Association Key Name (CKN) currently being used if MACsec is operational.
result.interconnectStatuses[].diagnostics.bundleOperationalStatus
enum
The operational status of the bundle interface.
result.interconnectStatuses[].diagnostics.bundleAggregationType
enum
The aggregation type of the bundle interface.
result.intent
object
The intent of the resource, as returned by interconnectGroups.get.
result.intent.topologyCapability
enum
result.configured
object
The configuration analysis, as returned by interconnectGroups.get.
result.configured.topologyCapability
object
result.configured.topologyCapability.supportedSla
enum
result.configured.topologyCapability.intendedCapabilityBlockers[]
object
result.configured.topologyCapability.intendedCapabilityBlockers[].blockerType
enum
result.configured.topologyCapability.intendedCapabilityBlockers[].explanation
string
[Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement.
result.configured.topologyCapability.intendedCapabilityBlockers[].documentationLink
string
[Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement.
result.configured.topologyCapability.intendedCapabilityBlockers[].metros[]
string
[Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". A blocker like INCOMPATIBLE_METROS will specify the problematic metros in this field.
result.configured.topologyCapability.intendedCapabilityBlockers[].facilities[]
string
[Output Only] Facilities used to explain this blocker in more detail. Like physicalStructure.metros.facilities.facility, this is a numeric string like "5467".
result.configured.topologyCapability.intendedCapabilityBlockers[].zones[]
string
[Output Only] Zones used to explain this blocker in more detail. Zone names are "zone1" and/or "zone2".
result.configured.topologyCapability.intendedCapabilityBlockers[].interconnects[]
string
[Output Only] Interconnects used to explain this blocker in more detail.
result.operational
object
The operational state of the group, including only active Interconnects.
result.operational.topologyCapability
object
result.operational.topologyCapability.supportedSla
enum
result.operational.topologyCapability.intendedCapabilityBlockers[]
object
result.operational.topologyCapability.intendedCapabilityBlockers[].blockerType
enum
result.operational.topologyCapability.intendedCapabilityBlockers[].explanation
string
[Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement.
result.operational.topologyCapability.intendedCapabilityBlockers[].documentationLink
string
[Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement.
result.operational.topologyCapability.intendedCapabilityBlockers[].metros[]
string
[Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". A blocker like INCOMPATIBLE_METROS will specify the problematic metros in this field.
result.operational.topologyCapability.intendedCapabilityBlockers[].facilities[]
string
[Output Only] Facilities used to explain this blocker in more detail. Like physicalStructure.metros.facilities.facility, this is a numeric string like "5467".
result.operational.topologyCapability.intendedCapabilityBlockers[].zones[]
string
[Output Only] Zones used to explain this blocker in more detail. Zone names are "zone1" and/or "zone2".
result.operational.topologyCapability.intendedCapabilityBlockers[].interconnects[]
string
[Output Only] Interconnects used to explain this blocker in more detail.
etag
string
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/compute.readonly
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM PermissionsIn addition to any permissions specified on the fields above, authorization requires one or more of the following IAM permissions:
compute.interconnectGroups.get
To find predefined roles that contain those permissions, see Compute Engine IAM Roles.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4