Documentation Oracle Cloud Infrastructure

Réparation sans fin

La réparation sans interruption (NTR) dans OCI permet la maintenance et la réparation des composants matériels ou logiciels sous-jacents sans nécessité de mettre fin aux instances en cours d'exécution ou de les évacuer.

Important

La fonction NTR est uniquement prise en charge sur les formes Bare Metal.

Cette approche contraste avec les méthodes traditionnelles de terminaison de réparation (TR), qui nécessitent une terminaison d'instance avant la poursuite de la maintenance. NTR réduit les interruptions de service et améliore la disponibilité des applications sur OCI. Le NTR englobe les types de maintenance suivants :

  • Réparations en temps d'arrêt : les instances sont arrêtées avant la maintenance. Le processus nécessite que l'hôte soit arrêté ou réinitialisé pendant la maintenance.
    • Action d'instance : STOP
  • Réparations en direct : la maintenance se produit lorsque les instances restent opérationnelles. Les instances restent en cours d'exécution, sans interruption ni mise hors tension pendant la maintenance.
    • Action d'instance : NONE
  • Réparation en arrière-plan en direct : cas d'utilisation dans lequel aucune action utilisateur n'est nécessaire et où OCI crée un événement de maintenance et exécute la réparation en arrière-plan.
    • Action d'instance : NONE
Important

Lancement de la maintenance : La maintenance NTR commence lorsque la fenêtre d'heure de début programmée est atteinte. Planifiez la maintenance au moment souhaité pour le lancement de la maintenance.

Evénements de maintenance

OCI fournit des événements de maintenance pour gérer les processus de maintenance d'infrastructure.

Les événements de maintenance sont créés lorsque votre instance/hôte a besoin d'une maintenance. Les événements informent les utilisateurs des activités de maintenance à venir affectant leurs instances. Les événements de maintenance apparaissent dans la ressource Maintenance d'instance de la console OCI. En outre, les événements de maintenance peuvent être gérés à l'aide de la CLI ou des kits SDK. Toutes les interfaces permettent aux utilisateurs de reprogrammer les fenêtres de maintenance, de surveiller la progression de la maintenance et d'effectuer les actions de pré-maintenance ou de post-maintenance nécessaires.

Par exemple, le lien suivant fournit un exemple de classe d'événement de maintenance définie en Python. InstanceMaintenanceEvent: https://docs.oracle.com/iaas/tools/python/latest/api/core/models/oci.core.models.InstanceMaintenanceEvent.html.

Interruption de réparation

Historiquement, la terminaison de la réparation (TR) est la seule méthode utilisée par OCI pour effectuer des réparations sur le matériel ou le logiciel sous-jacent d'une instance.

Ce processus nécessite l'évacuation et l'interruption de l'instance concernée avant que les réparations puissent commencer. La maintenance TR commence lorsque le client met fin à l'instance. Ensuite, la maintenance a lieu sans avoir à reprogrammer la maintenance.

Gestion des événements NTR à l'aide de la CLI

Les étapes suivantes fournissent un exemple de gestion des événements de maintenance via un processus de maintenance complet à l'aide de la CLI.

Phase de repérage

Identifier les événements de maintenance d'instance à venir.

Répertorier les événements de maintenance

oci compute instance-maintenance-event list --compartment-id <compartment-id>

Remplacez <compartment-id> par l'OCID de votre compartiment.

Exemple :

oci compute instance-maintenance-event list --compartment-id ocid1.tenancy.oc1..

Exemple de sortie :

{
  "data": [
    {
      "alternative-resolution-actions": [],
      "can-reschedule": true,
      "compartment-id": "ocid1.tenancy.oc1..",
      "correlation-token": "",
      "created-by": "SYSTEM",
      "defined-tags": {
        "Oracle-Tags": {
          "CreatedBy": "",
          "CreatedOn": "2026-01-29T21:51:09.112Z"
        }
      },
      "description": "Oracle scheduled a maintenance action for your instance that will be performed without any required downtime.",
      "display-name": "LIVE_HOST_MAINTENANCE",
      "estimated-duration": "null",
      "freeform-tags": {},
      "id": "ocid1.instancemaintenanceevent.oc1.ap-sydney-1.",
      "instance-action": "NONE",
      "instance-id": "ocid1.instance.oc1.ap-sydney-1.",
      "lifecycle-state": "SUCCEEDED",
      "maintenance-category": "FLEXIBLE",
      "maintenance-reason": "HARDWARE_REPLACEMENT",
      "start-window-duration": "null",
      "time-created": "2026-01-29T21:48:21.731000+00:00",
      "time-finished": "2026-01-29T23:10:42.551000+00:00",
      "time-hard-due-date": "2036-02-24T21:47:40.815000+00:00",
      "time-started": "2026-01-29T22:20:49.835000+00:00",
      "time-window-start": "2026-01-29T22:10:00+00:00"
    },
    {
      "alternative-resolution-actions": [],
      "can-reschedule": true,
      "compartment-id": "ocid1.tenancy.oc1..",
      "correlation-token": "",
      "created-by": "SYSTEM",
      "defined-tags": {},
      "description": "Oracle scheduled a maintenance action for your instance that will be performed without any required downtime.",
      "display-name": "LIVE_HOST_MAINTENANCE",
      "estimated-duration": "null",
      "freeform-tags": {},
      "id": "ocid1.instancemaintenanceevent.oc1.ap-sydney-1.",
      "instance-action": "NONE",
      "instance-id": "ocid1.instance.oc1.ap-sydney-1.",
      "lifecycle-state": "SCHEDULED",
      "maintenance-category": "FLEXIBLE",
      "maintenance-reason": "HARDWARE_REPLACEMENT",
      "start-window-duration": "null",
      "time-created": "2026-01-30T22:26:28.438000+00:00",
      "time-finished": null,
      "time-hard-due-date": "2036-02-25T22:25:53.697000+00:00",
      "time-started": null,
      "time-window-start": "2036-02-11T22:25:53.697000+00:00"
    }
  ]
}

Obtenir les détails de l'événement de maintenance d'instance

Consulter un événement de maintenance spécifique.

oci compute instance-maintenance-event get --instance-maintenance-event-id <instance-maintenance-event-id>

Remplacez <instance-maintenance-event-id> par l'OCID de l'événement spécifique.

Exemple :

oci compute instance-maintenance-event get --instance-maintenance-event-id ocid1.instancemaintenanceevent.oc1.ap-sydney-1...

Exemple de sortie :

{
  "data": {
    "additional-details": {
      "faultDetails": "[]",
      "repairDetails": "[]"
    },
    "alternative-resolution-actions": [],
    "can-delete-local-storage": false,
    "can-reschedule": true,
    "compartment-id": "ocid1.tenancy.oc1..",
    "correlation-token": "",
    "created-by": "SYSTEM",
    "defined-tags": {},
    "description": "Oracle scheduled a maintenance action for your instance that will be performed without any required downtime.",
    "display-name": "LIVE_HOST_MAINTENANCE",
    "estimated-duration": "null",
    "freeform-tags": {},
    "id": "ocid1.instancemaintenanceevent.oc1.ap-sydney-1.",
    "instance-action": "NONE",
    "instance-id": "ocid1.instance.oc1.ap-sydney-1.",
    "lifecycle-details": null,
    "lifecycle-state": "SCHEDULED",
    "maintenance-category": "FLEXIBLE",
    "maintenance-reason": "HARDWARE_REPLACEMENT",
    "start-window-duration": "null",
    "time-created": "2026-01-30T22:26:28.438000+00:00",
    "time-finished": null,
    "time-hard-due-date": "2036-02-25T22:25:53.697000+00:00",
    "time-started": null,
    "time-window-start": "2036-02-11T22:25:53.697000+00:00"
  },
  "etag": ""
}

Phase préalable à la maintenance

Replanifiez la fenêtre d'heure de début d'un événement de maintenance d'instance et effectuez les actions de pré-maintenance nécessaires.

Replanifier l'événement de maintenance d'instance

oci compute instance-maintenance-event update --instance-maintenance-event-id <instance-maintenance-event-id> --time-window-start "<time-window-start>"

Remplacez <instance-maintenance-event-id> par l'OCID de l'événement et <time-window-start> par l'heure de début souhaitée au format ISO 8601.

Exemple :

oci compute instance-maintenance-event update --instance-maintenance-event-id ocid1.instancemaintenanceevent.oc1.ap-sydney-1... --time-window-start "2026-01-30T22:40:53.697000+00:00"

Exemple de sortie :

{
    "opc-work-request-id": "ocid1.coreservicesworkrequest.oc1.ap-sydney-1..."
}
Important

Assurez-vous que toutes les actions de pré-maintenance sont terminées avant la fenêtre d'heure de début programmée.

Phase de surveillance

La maintenance commence à l'heure de début programmée. Patientez jusqu'à ce que la maintenance soit terminée.

Surveiller le statut de l'événement de maintenance d'instance

Surveillez le statut d'un événement de maintenance pendant l'exécution.

oci compute instance-maintenance-event get --instance-maintenance-event-id <instance-maintenance-event-id>

Remplacez <instance-maintenance-event-id> par l'OCID de l'événement.

Exemple :

oci compute instance-maintenance-event get --instance-maintenance-event-id ocid1.instancemaintenanceevent.oc1.ap-sydney-1...

Exemple de sortie :

{
  "data": {
    "additional-details": {
      "faultDetails": "[]",
      "repairDetails": "[]"
    },
    "alternative-resolution-actions": [],
    "can-delete-local-storage": false,
    "can-reschedule": true,
    "compartment-id": "ocid1.tenancy.oc1..",
    "correlation-token": "",
    "created-by": "SYSTEM",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "",
        "CreatedOn": "2026-01-30T22:39:54.637Z"
      }
    },
    "description": "Oracle scheduled a maintenance action for your instance that will be performed without any required downtime.",
    "display-name": "LIVE_HOST_MAINTENANCE",
    "estimated-duration": "null",
    "freeform-tags": {},
    "id": "ocid1.instancemaintenanceevent.oc1.ap-sydney-1.",
    "instance-action": "NONE",
    "instance-id": "ocid1.instance.oc1.ap-sydney-1.",
    "lifecycle-details": null,
    "lifecycle-state": "PROCESSING",
    "maintenance-category": "FLEXIBLE",
    "maintenance-reason": "HARDWARE_REPLACEMENT",
    "start-window-duration": "null",
    "time-created": "2026-01-30T22:26:28.438000+00:00",
    "time-finished": null,
    "time-hard-due-date": "2036-02-25T22:25:53.697000+00:00",
    "time-started": "2026-01-30T22:42:40.371000+00:00",
    "time-window-start": "2026-01-30T22:40:53.697000+00:00"
  },
  "etag": ""
}

Phase post-maintenance

Vous pouvez effectuer votre propre action post-maintenance, le cas échéant, une fois les événements de maintenance d'instance terminés.