Il est possible qu'une partie ou l'ensemble des informations de cette page ne s'appliquent pas au Cloud de confiance S3NS. Pour en savoir plus, consultez Différences par rapport à Google Cloud.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Événements de maintenance de l'infrastructure

Ce guide décrit les événements de maintenance d'infrastructure et leur impact sur les connexions Cloud Interconnect.

En quoi consistent les événements de maintenance d'infrastructure ?

Les événements de maintenance d'infrastructure correspondent à des périodes pendant lesquelles Cloud de Confiance effectue une maintenance sur l'équipement réseau, y compris celui des interconnexions Cloud Interconnect. Nous vous envoyons une notification, lorsque cela est possible, afin que vous puissiez planifier l'événement de maintenance d'infrastructure et éviter les temps d'arrêt.

Maintenance planifiée

Cloud de Confiance effectue de nombreux types d'événements de maintenance. Les différences entre les types d'événements de maintenance sont simplifiées, de sorte que les événements de maintenance de différents types se présentent de la même manière dans la Cloud de Confiance console. La plupart des types d'événements de maintenance planifiée se produisent entre 22h et 5h, heure locale de l'emplacement de l'appareil réseau. Par exemple, si l'appareil est situé dans la région asia-south1, la maintenance planifiée a généralement lieu entre 22h et 5h, heure normale de l'Inde (UTC+5:30). Les événements de maintenance planifiée n'ont pas d'intervalle défini entre eux, mais se produisent généralement plusieurs fois par an.

Un type d'événement de maintenance planifiée, une migration physique, a lieu du lundi au vendredi, de 9h à 17h, heure de la côte est des États-Unis.

Maintenance non planifiée

Des événements de maintenance d'urgence ou non programmés peuvent également se produire. Les événements d'urgence sont des événements irréguliers et non planifiés qui peuvent affecter les connexions Cloud Interconnect. Malheureusement, des événements d'urgence peuvent se produire à tout moment, sans préavis. Google vous recommande de créer des topologies réseau hybrides à haute disponibilité pour limiter les pannes de réseau causées par des événements de maintenance d'urgence.

La capacité totale affectée par un événement de maintenance non planifié varie en fonction de la nature de l'événement. Elle peut atteindre 100% de votre capacité sur une ou plusieurs de vos connexions Cloud Interconnect.

Maintenance urgente

Les événements de maintenance urgente sont semblables aux événements de maintenance planifiée, mais ils sont programmés moins de 14 jours à l'avance. De plus, ils ont un impact sur jusqu'à 100 % de la capacité totale de chacune de vos connexions Cloud Interconnect concernées.

Liens uniques et contrat de niveau de service

Un lien unique dans un domaine de disponibilité périphérique n'est associé à aucun contrat de niveau de service. Pour éviter toute perte d'accès à vos services pendant la maintenance, veillez à provisionner deux liaisons dans des domaines de disponibilité périphériques différents. Pour plus d'informations, consultez la section Créer des connexions Cloud Interconnect redondantes avec une capacité suffisante.

Recevoir des notifications d'événements

Vous recevez des notifications pour les événements de maintenance planifiée, non planifiée et urgente.

Les notifications concernant les événements de maintenance planifiée sont envoyées au moins 14 jours avant l'événement à l'adresse e-mail indiquée dans le champ nocContactEmail de l'objet Cloud Interconnect et sont affichées dans la méthode d'API interconnects.get. Pour en savoir plus, consultez la section Attribuer des contacts pour les notifications d'événements.

Lors d'événements non planifiés ou urgents, vous recevrez peut-être une notification pour une interruption, mais vous n'aurez pas suffisamment de temps pour rediriger le trafic. Pour réduire les risques de perturbations du trafic en raison d'interruptions d'urgence, consultez la page Bonnes pratiques.

Il est possible que les événements de maintenance ne se produisent pas comme prévu. Nous envoyons des notifications d'événements mises à jour si un événement de maintenance est reprogrammé ou annulé.

Les notifications n'apparaissent pas dans la console pour les utilisateurs interconnexion partenaire

Attribuer des contacts pour les notifications d'événements

Cloud Interconnect informe les propriétaires du projet et utilise également l' API Essential Contacts pour envoyer des notifications sur les événements de maintenance. Si vous n'attribuez pas de contact technique à un projet, les notifications sont envoyées aux contacts de remplacement, qui sont basés sur les rôles IAM.

Pour vous assurer de recevoir des notifications appropriées sur les événements de maintenance, spécifiez au moins un contact technique pour chaque projet hébergeant une connexion Cloud Interconnect ou un rattachement de VLAN.

Pour en savoir plus sur l'attribution de contacts techniques pour un projet, consultez la page Gérer les contacts pour les notifications.

Propriétés des notifications d'événements

Cette section s'applique à interconnexion dédiée, interconnexion cross-cloud et à Cross-Site Interconnect.

Avant un événement de maintenance planifiée de l'infrastructure, les utilisateurs reçoivent les notifications suivantes :

Un e-mail est envoyé à tous les propriétaires de projet de connexion Cloud Interconnect dès qu'une maintenance impactée est planifiée.
Un e-mail est envoyé à l'adresse indiquée dans le champ nocContactEmail de l'objet Cloud Interconnect. Vous pouvez rechercher et modifier cet objet dans la Cloud de Confiance console sur la page d'informations de Cloud Interconnect ou en utilisant la commande Google Cloud CLI suivante :
```
gcloud compute interconnects describe my-interconnect
```
Un e-mail est envoyé à tous les contacts techniques répertoriés pour le projet hébergeant la connexion Cloud Interconnect.

Lors d'un événement de maintenance non planifiée ou urgente de l'infrastructure, les utilisateurs reçoivent les notifications suivantes :

Un e-mail est envoyé à tous les propriétaires de projet de connexion Cloud Interconnect dès qu'une maintenance impactée est planifiée.
Un e-mail est envoyé à l'adresse indiquée dans le champ nocContactEmail de l'objet Cloud Interconnect.
Un e-mail est envoyé à tous les contacts techniques répertoriés pour le projet hébergeant la connexion Cloud Interconnect.

Notifications d'événements interconnexion partenaire

Avant un événement de maintenance planifiée de l'infrastructure, les utilisateurs Partner Interconnect reçoivent les notifications suivantes :

Un e-mail est envoyé à tous les contacts techniques du projet qui héberge le rattachement de VLAN.
Un e-mail est envoyé à tous les propriétaires du projet qui héberge le rattachement de VLAN.

États d'interruption

Les e-mails d'événement envoyés aux propriétaires du projet et aux contacts nocContactEmail incluent une section intitulée "État d'indisponibilité". La section suivante décrit les états de panne possibles :

Mis à jour : événement de maintenance précédemment programmé qui est mis à jour ou reprogrammé.
Dépassement : événement de maintenance précédemment programmé qui est en cours et qui prend plus de temps que prévu.
Terminé : événement de maintenance terminé.
Annulé : événement de maintenance précédemment programmé qui est annulé.
Nouveau : nouvel événement de maintenance.
Aucune modification : événement de maintenance précédemment programmé qui est toujours planifié comme prévu.

Afficher les événements de maintenance

Sélectionnez l'une des options suivantes :

gcloud

Pour afficher des informations sur votre connexion, y compris les événements de maintenance planifiée à venir, exécutez la commande suivante :

gcloud compute interconnects describe INTERCONNECT_NAME

Remplacez INTERCONNECT_NAME par le nom de la connexion Cloud Interconnect.

Le résultat ressemble à ce qui suit ; recherchez 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

API REST

Pour répertorier des informations sur votre connexion, y compris les événements de maintenance à venir, utilisez interconnects.get :

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet dans lequel se trouve la connexion Cloud Interconnect.
INTERCONNECT_NAME : nom de la connexion Cloud Interconnect.

Le résultat ressemble à ce qui suit :

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

Afficher les événements de maintenance dans Unified Maintenance

Vous pouvez utiliser Unified Maintenance pour afficher les événements de maintenance de l'infrastructure Cloud Interconnect et le configurer pour envoyer des alertes et des notifications concernant les événements de maintenance. Les notifications n'apparaissent pas dans Unified Maintenance pour les utilisateurs interconnexion partenaire.

Suivez les étapes de la page Configurer des alertes et des notifications, mais utilisez l'un des filtres d'inclusion suivants lorsque vous êtes invité à en créer un :

Ce filtre n'inclut que les notifications de maintenance planifiée :

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

Ce filtre n'inclut que les notifications de maintenance urgente :

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

Ce filtre ne contient que les notifications de maintenance non planifiée :

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

Vous pouvez également afficher les événements de maintenance à l'état Planifié en consultant la section Afficher les maintenances de ressources à l'aide de l'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"

Étapes suivantes

Suivez les bonnes pratiques pour implémenter Cloud Interconnect.
Gérer les contacts pour les notifications