本頁面由 Cloud Translation API 翻譯而成。

基礎架構維護事件

本指南說明基礎架構維護事件，以及這些事件如何影響 Cloud Interconnect 連線。

什麼是基礎架構維護事件

基礎架構維護事件是指 Google Cloud 對網路設備 (包括 Cloud Interconnect 的設備) 進行維護的時間。我們會盡可能提供通知，方便您規劃基礎架構維護事件，並避免服務中斷。

預定的維護作業

Google Cloud 執行多種維護事件。維護作業類型之間的差異已簡化，因此不同類型的維護作業在 Google Cloud 控制台中看起來都一樣。大多數的預定維護事件會在當地時間晚上 10 點至隔天凌晨 5 點之間發生，舉例來說，如果裝置位於 asia-south1，則預定維護作業通常會在印度標準時間 (UTC+5:30) 的晚上 10 點到隔天凌晨 5 點之間進行。預定的維護事件沒有一定的發生頻率，但通常每年會發生數次。

實體遷移是一種預定維護事件，會在東部標準時間週一至週五上午 9 點至下午 5 點發生。

未預定的維護作業

也可能會發生緊急或非預定的維護事件。緊急事件是指可能影響 Cloud Interconnect 連線的不定期、非預期事件。很遺憾，緊急事件可能隨時發生，且不會事先發出警示。Google 建議您建立高可用性的混合式網路拓撲，以便因應緊急維護事件造成的網路中斷。

單一連結和服務水準協議

一個邊緣可用性網域中的單一連結不含SLA。為避免在維護期間失去服務存取權，請務必在不同的邊緣可用性網域中佈建兩個連結。詳情請參閱「建立備援的 Cloud Interconnect 連線，並確保有足夠的容量」。

接收事件通知

大部分的通知都是針對已規劃和潛在的服務中斷情形，讓您採取預防措施，例如重新導向流量。系統會在預定維護事件發生前至少 14 天，將通知傳送至 Cloud Interconnect 物件 nocContactEmail 欄位中列出的電子郵件地址，並顯示在 interconnects.get API 方法中。詳情請參閱「指派事件通知聯絡人」。

在發生緊急事件的極少數情況下，您可能會收到中斷服務的通知，但沒有足夠的時間重新導向流量。如要降低因緊急中斷而導致流量中斷的可能性，請參閱最佳做法。

維護事件可能不會按計畫進行。如果維護事件重新排定或取消，我們會傳送更新的事件通知。

合作夥伴互連網路使用者不會在 Google Cloud 控制台中看到通知。

指派事件通知聯絡人

Cloud Interconnect 會通知專案擁有者，並使用 Essential Contacts API 傳送即將發生的維護事件通知。如果您未為專案指派技術聯絡人，系統會將通知傳送給備用聯絡人，這些聯絡人是根據 IAM 角色指定。

為確保您能收到維護事件的適當通知，請為所有代管 Cloud Interconnect 連線或 VLAN 連結的專案，指定至少一位技術聯絡人。

如要進一步瞭解如何指派專案的技術聯絡人，請參閱「管理通知聯絡人」。

專屬互連網路事件通知

本節適用於 Dedicated Interconnect、Cross-Cloud Interconnect 和 Cross-Site Interconnect。

在預定的基礎架構維護事件開始前，使用者會收到下列通知：

一旦排定影響維護作業，系統就會立即傳送電子郵件給所有 Cloud Interconnect 連線專案擁有者。
系統會將電子郵件傳送至 Cloud Interconnect 物件的 nocContactEmail 欄位中列出的地址。您可以在 Google Cloud 控制台的 Cloud Interconnect 詳細資料頁面中找到並編輯這個物件，也可以使用下列 Google Cloud CLI 指令：
```
gcloud compute interconnects describe my-interconnect
```
系統會傳送電子郵件給代管 Cloud Interconnect 連線的專案中列出的任何技術支援聯絡人。
通知會顯示在 Google Cloud 控制台「活動」分頁和「通知」區域。

合作夥伴互連網路事件通知

在預定的基礎架構維護事件開始前，合作夥伴互連網路使用者會收到下列通知：

系統會傳送電子郵件給代管 VLAN 連結的專案的任何技術聯絡人。
系統會傳送電子郵件給代管 VLAN 連結的專案所有專案擁有者。

服務中斷狀態

傳送給專案擁有者和 nocContactEmail 聯絡人的事件電子郵件中，會包含標題為「停機狀態」的部分。以下說明可能的停機狀態：

已更新：先前已排定的維護活動已更新或重新排定。
超時：預定維護事件正在進行中，但完成時間超出預期。
已完成：維護事件已完成。
已取消：先前預定的維護活動已取消。
新：新的維護事件。
無變更：先前已排定的維護事件仍按原先計畫進行。

查看即將進行的維護事件

選取下列選項之一：

gcloud

如要顯示連線相關資訊 (包括即將發生的維護事件)，請執行下列指令：

gcloud compute interconnects describe INTERCONNECT_NAME

將 INTERCONNECT_NAME 替換為 Cloud Interconnect 的名稱。

輸出結果會與以下內容相似，請找出 expectedOutages：

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"
]
}

後續步驟

實作 Cloud Interconnect 最佳做法
管理通知聯絡人

基礎架構維護事件 透過集合功能整理內容 你可以依據偏好儲存及分類內容。