Method: projects.locations.zones.interconnects.diagnose

获取单个互连资源的诊断信息。

HTTP 请求

GET https://edgenetwork.googleapis.com/v1/{name=projects/*/locations/*/zones/*/interconnects/*}:diagnose

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。互联资源的名称。

请求正文

请求正文必须为空。

响应正文

如果成功,响应正文将包含结构如下的数据:

DiagnoseInterconnectResponse 包含特定互连的当前诊断信息。

JSON 表示法
{
  "updateTime": string,
  "result": {
    object (InterconnectDiagnostics)
  }
}
字段
updateTime

string (Timestamp format)

上次更新互连诊断信息的时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

result

object (InterconnectDiagnostics)

特定互连的网络状态。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情,请参阅身份验证概览

InterconnectDiagnostics

有关互连的诊断信息,包含有关连接的 Google 端的详细最新技术信息。

JSON 表示法
{
  "macAddress": string,
  "linkLayerAddresses": [
    {
      object (LinkLayerAddress)
    }
  ],
  "links": [
    {
      object (LinkStatus)
    }
  ]
}
字段
macAddress

string

互连的捆绑接口的 MAC 地址。

LinkStatus

描述互连连接中各链路的状态。

JSON 表示法
{
  "circuitId": string,
  "lacpStatus": {
    object (LinkLACPStatus)
  },
  "lldpStatuses": [
    {
      object (LinkLLDPStatus)
    }
  ],
  "packetCounts": {
    object (PacketCounts)
  }
}
字段
circuitId

string

在开通期间由 Google 分配的相应链接的唯一 ID。

lacpStatus

object (LinkLACPStatus)

描述 LACP 链路的状态。

lldpStatuses[]

object (LinkLLDPStatus)

LinkLLDPStatus 对象列表,用于描述互连上每条链路的每个对等方的 LLDP 状态。

packetCounts

object (PacketCounts)

此链接的特定数据包计数统计信息。

LinkLACPStatus

描述 LACP 链路的状态。

JSON 表示法
{
  "state": enum (State),
  "googleSystemId": string,
  "neighborSystemId": string,
  "aggregatable": boolean,
  "collecting": boolean,
  "distributing": boolean
}
字段
state

enum (State)

LACP 链路的状态。

googleSystemId

string

LACP 交换中 Google 一端的端口的系统 ID。

neighborSystemId

string

LACP 交换中邻居一端的端口的系统 ID。

aggregatable

boolean

值为 true 表示相应参与者将允许该链接用作聚合的一部分。值为 false 表示相应链接应作为单独的链接使用。

collecting

boolean

如果为 true,则表示参与者正在收集链接上的传入帧;否则为 false

distributing

boolean

如果为 true,则表示参与者正在分发传出帧;如果为 false,则表示分发已停用

LACP 链路的状态枚举值。

枚举
UNKNOWN 表示状态处于未知状态的默认状态。
ACTIVE 已在捆绑套装中配置了链路,并且链路处于有效状态。
DETACHED 未在软件包中配置链接,这意味着对象的其余部分应为空。

LinkLLDPStatus

描述 LLDP 链接。

JSON 表示法
{
  "peerSystemName": string,
  "peerSystemDescription": string,
  "peerChassisId": string,
  "peerChassisIdType": string,
  "peerPortId": string,
  "peerPortIdType": string
}
字段
peerSystemName

string

对等系统在管理上分配的名称。

peerSystemDescription

string

LLDP 对等方的网络实体的文本说明。

peerChassisId

string

与传输 LLDP 代理相关联的端点标识符的对等机箱组件。

peerChassisIdType

string

对等底盘标识符字符串的格式和来源。

peerPortId

string

与传输 LLDP 代理相关联的端点标识符的端口组件。如果指定的端口是 IEEE 802.3 中继器端口,则此 TLV 是可选的。

peerPortIdType

string

对等端口标识符字符串的格式和来源。

PacketCounts

包含一组与接口相关的统计信息对象。

JSON 表示法
{
  "inboundUnicast": string,
  "inboundErrors": string,
  "inboundDiscards": string,
  "outboundUnicast": string,
  "outboundErrors": string,
  "outboundDiscards": string
}
字段
inboundUnicast

string (int64 format)

已传送的数据包数。

inboundErrors

string (int64 format)

包含错误的入站数据包的数量。

inboundDiscards

string (int64 format)

即使未检测到任何错误,仍选择丢弃的入站数据包数量,以防止这些数据包可交付。

outboundUnicast

string (int64 format)

请求传输的数据包总数。

outboundErrors

string (int64 format)

因错误而无法传输的出站数据包数量。

outboundDiscards

string (int64 format)

即使未检测到任何错误,仍选择丢弃的出站数据包数量,以防止其被传输。