インフラストラクチャメンテナンスイベント

このガイドでは、インフラストラクチャメンテナンスイベントと、それが Cloud Interconnect 接続に与える影響について説明します。

インフラストラクチャメンテナンスイベントとは

インフラストラクチャメンテナンスイベントとは、Google Cloud が、ネットワーク機器（Cloud Interconnect 用の機器など）の定期的なメンテナンスを実施することです。通常、このイベントは事前にスケジュール設定されます。可能な限り通知が提供されるため、ユーザーはインフラストラクチャメンテナンスイベントに対応した計画を立て、ダウンタイムを回避できます。インフラストラクチャメンテナンスイベントの間隔は決まっていませんが、通常は年に数回実行されます。

緊急メンテナンスイベントやスケジュール設定されていないメンテナンスイベントが実行されることもあります。緊急イベントとは、Cloud Interconnect 接続に影響する可能性のある、不定期で計画外のイベントです。ご迷惑をおかけすることになり恐縮ですが、緊急イベントはいつでも警告なく発生する可能性があります。緊急メンテナンスイベントによるネットワーク停止を軽減するために、高可用性のハイブリッドネットワークトポロジを作成することをおすすめします。

単一のエッジアベイラビリティドメインに単一のリンクをプロビジョニングするだけでは、SLA を保証できません。メンテナンス中にサービスにアクセスできなくなることがないように、異なるエッジアベイラビリティドメインに 2 つのリンクをプロビジョニングするようにしてください。詳細については、十分な容量の冗長 Cloud Interconnect 接続を作成するをご覧ください。

イベント通知の受け取り

ほとんどの通知は、計画された中断や、中断の可能性に関するものであるため、トラフィックのリダイレクトなどの予防的な対応を行うことができます。ただし、緊急イベントが発生した場合は、中断の通知を受け取っても、トラフィックをリダイレクトする時間が十分にない可能性があります。緊急の中断によるトラフィック中断の可能性を低減するためには、ベストプラクティスをご覧ください。

メンテナンスイベントは予定どおりに実行されない場合もあります。メンテナンスイベントのスケジュールが変更またはキャンセルされた場合は、更新されたイベント通知が送信されます。

通知は、Partner Interconnect ユーザーの Google Cloud コンソールには表示されません。

イベント通知の連絡先の割り当て

Cloud Interconnect はプロジェクトオーナーに通知しますが、Essential Contacts API を使用して今後のメンテナンスイベントに関する通知も送信します。プロジェクトに技術担当者を割り当てていない場合、通知は IAM ロールに基づくフォールバックの連絡先に送信されます。

メンテナンスイベントに関する適切な通知を受け取れるようにするため、Dedicated Interconnect 接続または VLAN アタッチメントをホストするプロジェクトには、少なくとも 1 つの技術担当者の連絡先を指定してください。

プロジェクトの技術担当者の割り当てについて詳しくは、通知の連絡先の管理をご覧ください。

Dedicated Interconnect のイベント通知

スケジュール設定されたインフラストラクチャメンテナンスイベントの前には、Dedicated Interconnect のユーザーに次の通知が送信されます。

影響のあるメンテナンスがスケジュールされると、すべての Dedicated Interconnect 接続のプロジェクトオーナーにメールが送信されます。
メールは、Cloud Interconnect オブジェクトの nocContactEmail フィールドに記載されているアドレスに送信されます。このオブジェクトは、Google Cloud コンソールの Cloud Interconnect の詳細ページで、または次の Google Cloud CLI コマンドを使用して、検索および編集できます。
```
gcloud compute interconnects describe my-interconnect
```
Dedicated Interconnect 接続をホストするプロジェクトにリストされている技術担当者にメールが送信されます。
通知は、Google Cloud コンソールの [アクティビティ] タブと [通知] 領域に表示されます。

Partner Interconnect のイベント通知

スケジュール設定されたインフラストラクチャメンテナンスイベントの前には、Partner Interconnect のユーザーに次の通知が送信されます。

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 のベストプラクティスを実施する
通知の連絡先を管理する

インフラストラクチャ メンテナンス イベント