基础架构维护事件

本指南介绍基础架构维护事件以及这些事件对 Cloud Interconnect 连接的影响。

什么是基础架构维护事件

基础架构维护事件是 Google Cloud 对网络设备（包括 Cloud Interconnect 的设备）进行定期维护的时间。这些事件通常是提前安排的，我们会尽可能提供通知，使您能够针对基础架构维护事件进行规划并防止停机。基础架构维护事件相隔的时间并不固定，但通常是一年几次。

此外，也可能会发生紧急或计划外维护事件。紧急事件是非固定、计划外的事件，可能会影响 Cloud Interconnect 连接。遗憾的是，紧急事件可能会随时发生，事先不会发出警告。Google 建议您创建高可用性混合网络拓扑，以缓解由紧急维护事件引起的网络中断。

一个边缘可用性网域的单个链路没有服务等级协议 (SLA)。为防止在维护期间失去服务的访问权限，请确保在不同的边缘可用性网域中预配两个链路。如需了解详情，请参阅创建具有足够容量的冗余 Cloud Interconnect 连接。

接收事件通知

大多数通知适用于计划内和潜在中断，因此您可以执行预防措施，例如重定向流量。但是，在发生罕见的紧急事件的情况下，您可能会收到中断通知，但没有足够的时间来重定向流量。如需降低由于紧急中断而导致流量中断的可能性，请参阅最佳实践。

维护事件可能无法按计划发生。如果维护事件被重新安排或取消，我们会发送更新后的事件通知。

对于合作伙伴互连用户，通知不会显示在 Google Cloud 控制台中。

为事件通知分配联系人

Cloud Interconnect 会通知项目所有者，还会使用 Essential Contacts API 发送有关即将进行的维护事件的通知。如果您没有为项目分配技术联系人，则通知将发送给基于 IAM 角色的后备联系人。如果您没有为项目分配技术联系人，则通知将发送给基于 IAM 角色的后备联系人。

为确保您能够接收有关维护事件的适当通知，请为托管专用互连连接或 VLAN 连接的任何项目指定至少一个技术联系人。

如需详细了解如何为项目分配技术联系人，请参阅管理通知联系人。

专用互连事件通知

在安排的基础架构维护事件发生之前，专用互连用户会收到以下通知：

在计划好有影响的维护后，系统会立即向所有专用互连连接项目所有者发送电子邮件。
电子邮件会发送到 Cloud Interconnect 对象的 nocContactEmail 字段中列出的地址。您可以在 Google Cloud 控制台的 Cloud Interconnect 详情页面上或使用以下 Google Cloud CLI 命令找到和编辑此对象：
```
gcloud compute interconnects describe my-interconnect
```
系统会向为托管专用互连连接的项目列出的任何技术联系人发送电子邮件。
通知会显示在 Google Cloud 控制台的活动标签页和通知区域中。

合作伙伴互连事件通知

在安排的基础架构维护事件发生之前，合作伙伴互连用户会收到以下通知：

系统会向用于托管 VLAN 连接的项目的任何技术联系人发送电子邮件。
系统会向用于托管 VLAN 连接的项目的所有项目所有者发送电子邮件。

查看即将进行的维护事件

从下列选项中选择一项：

gcloud

如需显示有关连接的信息（包括即将进行的维护事件），请运行以下命令：

gcloud compute interconnects describe INTERCONNECT_NAME

将 INTERCONNECT_NAME 替换为 Cloud Interconnect 的名称。

输出类似于以下内容：

adminEnabled: true
availableFeatures:
- IF_MACSEC
circuitInfos:
- customerDemarcId: demarc-0
  googleCircuitId: circuit-0
  googleDemarcId: local-demarc-0
creationTimestamp: '2021-12-15T17:02:48.829-08:00'
customerName: Cymbal Group
description: Interconnect connection
expectedOutages:
- description: ''
  endTime: '1705520100000'
  issueType: IT_OUTAGE
  name: pcr-764913
  source: NSRC_GOOGLE
  startTime: '1705501500000'
  state: CANCELLED
- description: ''
  endTime: '1707304200000'
  issueType: IT_OUTAGE
  name: pcr-777490
  source: NSRC_GOOGLE
  startTime: '1707285600000'
  state: COMPLETED
googleIpAddress: 192.0.2.0/24
googleReferenceId: '6006458259035'
id: '249691500371717847'
interconnectType: IT_PRIVATE
kind: compute#interconnect
labelFingerprint: 42WmSpB8rSM=
linkType: LINK_TYPE_ETHERNET_10G_LR
location: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnectLocations/sjc-zone1-6
macsec:
  failOpen: false
  preSharedKeys:
  - name: key-1
    startTime: '2023-08-08T21:09:21.385Z'
macsecEnabled: false
name: cymbal-group-interconnect
nocContactEmail: cloudysanfrancisco@gmail.com
operationalStatus: OS_ACTIVE
peerIpAddress: 192.0.2.0/24
provisionedLinkCount: 1
requestedLinkCount: 1
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME
state: ACTIVE

REST API

如需列出有关连接的信息（包括即将进行的维护事件），请使用 interconnects.get：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME

替换以下内容：

PROJECT_ID：Cloud Interconnect 所在的项目 ID
INTERCONNECT_NAME：Cloud Interconnect 的名称

输出类似于以下内容：

{
"kind": "compute#interconnect",
"description": "Interconnect connection",
"selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME",
"id": "249691500371717847",
"creationTimestamp": "2021-12-15T17:02:48.829-08:00",
"name": "INTERCONNECT_NAME",
"location": "https://www.googleapis.com/compute/v1/projects/INTERCONNECT_NAME/global/interconnectLocations/sjc-zone1-6",
"linkType": "LINK_TYPE_ETHERNET_10G_LR",
"requestedLinkCount": 1,
"interconnectType": "IT_PRIVATE",
"adminEnabled": true,
"nocContactEmail": "",
"customerName": "Cymbal Group",
"operationalStatus": "OS_ACTIVE",
"provisionedLinkCount": 1,
"peerIpAddress": "192.0.2.0/24",
"googleIpAddress": "192.0.2.0/24",
"googleReferenceId": "6006458259035",
"expectedOutages": [
  {
    "name": "pcr-764913",
    "description": "",
    "source": "NSRC_GOOGLE",
    "state": "CANCELLED",
    "issueType": "IT_OUTAGE",
    "startTime": "1705501500000",
    "endTime": "1705520100000"
  },
  {
    "name": "pcr-777490",
    "description": "",
    "source": "NSRC_GOOGLE",
    "state": "COMPLETED",
    "issueType": "IT_OUTAGE",
    "startTime": "1707285600000",
    "endTime": "1707304200000"
  }
],
"circuitInfos": [
  {
    "googleCircuitId": "circuit-0",
    "googleDemarcId": "local-demarc-0",
    "customerDemarcId": "demarc-0"
  }
],
"labelFingerprint": "42WmSpB8rSM=",
"state": "ACTIVE",
"macsec": {
  "preSharedKeys": [
    {
      "name": "key-1",
      "startTime": "2023-08-08T21:09:21.385Z"
    }
  ],
  "failOpen": false
},
"macsecEnabled": false,
"availableFeatures": [
  "IF_MACSEC"
]
}

服务中断状态

发送给项目所有者和 nocContactEmail 联系人的事件电子邮件包含一个标题为“服务中断状态”的部分。下面介绍了可能的服务中断状态：

已更新：先前安排的维护事件，已更新或已重新安排。
已完成：维护事件已完成。
已取消：先前安排的维护事件，被取消。
新：新的维护事件。
没有变化：先前计划的维护事件，仍然按先前计划进行安排。

后续步骤

实施 Cloud Interconnect 最佳实践
管理通知联系人