Oracle Cloud Infrastructure - Dokumentation

Nicht endende Reparatur

Non-Terminating Repair (NTR) in OCI ermöglicht die Wartung und Reparatur der zugrunde liegenden Hardware- oder Softwarekomponenten, ohne dass ausgeführte Instanzen beendet oder evakuiert werden müssen.

Wichtig

NTR wird nur auf Bare-Metal-Ausprägungen unterstützt.

Dieser Ansatz steht im Gegensatz zu den herkömmlichen Methoden zur Beenden der Reparatur (TR), bei denen eine Instanzbeendigung erforderlich ist, bevor die Wartung fortgesetzt wird. NTR minimiert Serviceunterbrechungen und verbessert die Anwendungsverfügbarkeit auf OCI. NTR umfasst die folgenden Wartungstypen:

  • Ausfallzeitreparaturen: Instanzen werden vor der Wartung gestoppt. Der Host muss während der Wartung heruntergefahren oder neu gestartet werden.
    • Instanzaktion: STOP
  • Live-Reparaturen: Die Wartung erfolgt, während die Instanzen betriebsbereit bleiben. Instanzen verbleiben in einem aktiven Status, ohne dass während der Wartung eine Beendigung oder ein Ausschalten erforderlich ist.
    • Instanzaktion: NONE
  • Live-Hintergrundreparatur: Ein Anwendungsfall, in dem keine Benutzeraktion erforderlich ist und OCI ein Wartungsereignis erstellt und die Reparatur im Hintergrund ausführt.
    • Instanzaktion: NONE
Wichtig

Instandhaltungsstart: Die NTR-Wartung beginnt, wenn das geplante Startzeitfenster erreicht ist. Planen Sie die Wartung zum gewünschten Zeitpunkt für die Wartungsinitiierung.

Wartungsereignisse

OCI stellt Wartungsereignisse zur Verwaltung von Infrastrukturwartungsprozessen bereit.

Wartungsereignisse werden erstellt, wenn die Instanz/der Host gewartet werden muss. Die Ereignisse benachrichtigen Benutzer über bevorstehende Wartungsaktivitäten, die sich auf ihre Instanzen auswirken. Wartungsereignisse werden in der Instanzwartungsressource in der OCI-Konsole angezeigt. Darüber hinaus können Wartungsereignisse mit der CLI oder SDKs verwaltet werden. Über alle Schnittstellen können Benutzer Wartungsfenster neu planen, den Wartungsfortschritt überwachen und erforderliche Aktionen vor der Wartung oder nach der Wartung ausführen.

Beispiel: Der folgende Link enthält ein Beispiel für eine in Python definierte Wartungsereignisklasse. InstanceMaintenanceEvent: https://docs.oracle.com/iaas/tools/python/latest/api/core/models/oci.core.models.InstanceMaintenanceEvent.html.

Reparatur wird beendet

In der Vergangenheit ist das Beenden von Reparaturen (TR) die einzige Methode für OCI, um Reparaturen an der zugrunde liegenden Hardware oder Software einer Instanz durchzuführen.

Dieser Prozess erfordert Evakuierung und Beendigung der betroffenen Instanz, bevor Reparaturen beginnen können. Die TR-Wartung beginnt, wenn der Kunde die Instanz beendet. Dann erfolgt die Wartung, ohne dass die Wartung neu geplant werden muss.

NTR-Ereignisse mit der CLI verwalten

Die folgenden Schritte enthalten ein Beispiel für die Verwaltung von Wartungsereignissen über einen gesamten Wartungsprozess mit der CLI.

Phase erkennen

Bevorstehende Instanzwartungsereignisse identifizieren.

Wartungsereignisse auflisten

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

Ersetzen Sie <compartment-id> durch die OCID Ihres Compartments.

Beispiel:

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

Beispielausgabe:

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

Instanzwartungsereignisdetails abrufen

Auf dieser Seite zeigen Sie ein bestimmtes Wartungsereignis an.

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

Ersetzen Sie <instance-maintenance-event-id> durch die OCID des jeweiligen Ereignisses.

Beispiel:

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

Beispielausgabe:

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

Vor der Wartung

Planen Sie das Startzeitfenster eines Instanzwartungsereignisses neu, und führen Sie alle erforderlichen Aktionen vor der Wartung aus.

Instanzwartungsereignis neu planen

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

Ersetzen Sie <instance-maintenance-event-id> durch die OCID des Ereignisses und <time-window-start> durch die gewünschte Startzeit im ISO 8601-Format.

Beispiel:

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"

Beispielausgabe:

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

Stellen Sie sicher, dass alle Vorwartungsaktionen vor dem geplanten Startzeitfenster abgeschlossen sind.

Überwachungsphase

Die Wartung beginnt bei der geplanten Startzeit. Warten Sie, bis die Wartung abgeschlossen ist.

Status des Überwachungsinstanzwartungsereignisses

Den Status eines Wartungsereignisses während der Ausführung überwachen.

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

Ersetzen Sie <instance-maintenance-event-id> durch die OCID des Ereignisses.

Beispiel:

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

Beispielausgabe:

{
  "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 nach der Wartung

Nach Abschluss der Instanzwartungsereignisse können Sie gegebenenfalls eine eigene Aktion nach der Wartung ausführen.