基礎架構維護事件

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

基礎架構維護事件

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

預定的維護作業

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

其中一種排定的維護事件是實體遷移，時間為東部時間週一至週五上午 9 點至下午 5 點。

非預定的維護作業

此外，也可能會發生緊急或非預定的維護事件。緊急事件是指不定期且未經規劃的事件，可能會影響 Cloud Interconnect 連線。很遺憾，緊急事件可能隨時發生，不會事先警告。Google 建議您建立高可用性混合式網路拓撲，以減緩緊急維護事件造成的網路中斷。

受臨時維護事件影響的總容量，會因事件性質而異。這可能代表一或多個 Cloud Interconnect 連線的容量已達上限。

緊急維護

緊急維護活動與排定的維護活動類似，但排定時間提前不到 14 天。此外，這些事件還會影響每個受影響的 Cloud Interconnect 連線，最多可達總容量的 100%。

單一邊緣可用性網域中的單一連結不適用服務水準協議。為避免維護期間無法存取服務，請務必在不同的邊緣可用性網域中佈建兩條連結。詳情請參閱建立備援 Cloud Interconnect 連線，並提供足夠的容量。

接收活動通知

您會收到計畫內、計畫外和緊急維護事件的通知。

系統會在預定維護活動前至少 14 天，將通知傳送至 Cloud Interconnect 物件 nocContactEmail 欄位中列出的電子郵件地址，並顯示在 interconnects.get API 方法中。 詳情請參閱「指派活動通知聯絡人」。

在未經規劃或緊急事件期間，您可能會收到中斷通知，但沒有足夠時間重新導向流量。如要減少因緊急中斷而導致流量中斷的機率，請參閱最佳做法。

維護事件可能不會如期發生。如果維護事件改期或取消，我們會傳送更新的活動通知。

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

指派活動通知聯絡人

Cloud Interconnect 會通知專案擁有者，並使用重要聯絡人 API 傳送維護事件通知。如果沒有為專案指派技術聯絡人，系統會根據 IAM 角色，將通知傳送給備用聯絡人。

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

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

活動通知屬性

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

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

  • 只要排定會影響服務的維護作業，系統就會立即傳送電子郵件給所有 Cloud Interconnect 連線專案擁有者。

  • 系統會將電子郵件傳送至 Cloud Interconnect 物件的「nocContactEmail」欄位中列出的地址。您可以在 Cloud Interconnect 詳細資料頁面的 Google Cloud 控制台中尋找及編輯這個物件，也可以使用下列 Google Cloud CLI 指令：

    gcloud compute interconnects describe my-interconnect

  • 系統會將電子郵件傳送至 Cloud Interconnect 連線所屬專案列出的所有技術聯絡人。

在臨時或緊急基礎架構維護事件期間，使用者會收到下列通知：

  • 只要排定會影響服務的維護作業，系統就會立即傳送電子郵件給所有 Cloud Interconnect 連線專案擁有者。

  • 系統會將電子郵件傳送至 Cloud Interconnect 物件的「nocContactEmail」欄位中列出的地址。

  • 系統會將電子郵件傳送至 Cloud Interconnect 連線所屬專案列出的所有技術聯絡人。

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

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

  • 系統會傳送電子郵件給裝載 VLAN 連結的專案技術聯絡人。

  • 系統會傳送電子郵件給代管 VLAN 連結的專案的所有擁有者。

服務中斷狀態

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

  • Updated (已更新)：已更新或重新排定的先前排定維護事件。

  • 超出時間：先前排定的維護事件正在進行中，但完成時間超出預期。

  • 已完成：已完成的維護事件。

  • 已取消：先前排定的維護活動已取消。

  • 新：新的維護事件。

  • 沒有變更：先前排定的維護事件仍按照原定計畫進行。

查看維護事件

選取下列選項之一：

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 基礎架構維護事件，並設定「統一維護」傳送維護事件的快訊和通知。合作夥伴互連網路使用者不會在 Unified Maintenance 收到通知。

按照「設定快訊和通知」頁面的步驟操作，但系統提示建立篩選器時，請使用下列其中一個納入篩選器：

  • 這個篩選器只包含預定維護通知：

    log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Planned Outage.*"

  • 這個篩選器只會顯示緊急維護通知：

    log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Urgent Maintenance.*"

  • 這個篩選器只包含非預期維護通知：

    log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Unplanned Outage.*"

如要查看狀態為「已排定」的維護事件，請參閱「使用 API 查看資源維護作業」。

$ curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/resourceMaintenances?filter=resource.type%3D%22compute.googleapis.com/Interconnect%22%20AND%20state%3D%22SCHEDULED%22"

後續步驟