Documentación de Oracle Cloud Infrastructure

Reparación sin terminación

La reparación no terminal (NTR) en OCI permite el mantenimiento y la reparación de componentes de hardware o software subyacentes sin necesidad de terminar o evacuar instancias en ejecución.

Importante

NTR solo está soportado en unidades con hardware dedicado.

Este enfoque contrasta con los métodos tradicionales de terminación de reparación (TR), que requieren la terminación de la instancia antes de que se realice el mantenimiento. NTR minimiza las interrupciones del servicio y mejora la disponibilidad de las aplicaciones en OCI. NTR abarca los siguientes tipos de mantenimiento:

  • Reparaciones de tiempo de inactividad: las instancias se paran antes del mantenimiento. El proceso requiere que el host se cierre o se reinicie durante el mantenimiento.
    • Instance Action: STOP
  • Reparaciones en directo: el mantenimiento se produce mientras las instancias permanecen operativas. Las instancias permanecen en estado de ejecución, sin que sea necesaria la terminación ni el apagado durante el mantenimiento.
    • Instance Action: NONE
  • Reparación en segundo plano activa: caso de uso en el que no se necesita ninguna acción del usuario y OCI crea un evento de mantenimiento y ejecuta la reparación en segundo plano.
    • Instance Action: NONE
Importante

Iniciación de mantenimiento: el mantenimiento de NTR comienza cuando se alcanza la ventana de hora de inicio programada. Programe el mantenimiento en el momento deseado para el inicio del mantenimiento.

Eventos de mantenimiento

OCI proporciona eventos de mantenimiento para gestionar los procesos de mantenimiento de la infraestructura.

Los eventos de mantenimiento se crean cuando su instancia/host necesita mantenimiento. Los eventos notifican a los usuarios las próximas actividades de mantenimiento que afectan a sus instancias. Los eventos de mantenimiento aparecen en el recurso de mantenimiento de instancias de la consola de OCI. Además, los eventos de mantenimiento se pueden gestionar mediante la CLI o los SDK. Todas las interfaces permiten a los usuarios reprogramar ventanas de mantenimiento, supervisar el progreso del mantenimiento y realizar las acciones necesarias de mantenimiento previo o posterior.

Por ejemplo, el siguiente enlace proporciona un ejemplo de una clase de evento de mantenimiento definida en Python. InstanceMaintenanceEvent: https://docs.oracle.com/iaas/tools/python/latest/api/core/models/oci.core.models.InstanceMaintenanceEvent.html.

Terminando reparación

Históricamente, la terminación de la reparación (TR) es el único método para que OCI realice reparaciones en el hardware o software subyacente de una instancia.

Este proceso requiere la evacuación y la terminación de la instancia afectada antes de que puedan comenzar las reparaciones. El mantenimiento de TR comienza cuando el cliente finaliza la instancia. Luego, el mantenimiento se realiza sin tener que reprogramar el mantenimiento.

Gestión de eventos de NTR con la CLI

En los siguientes pasos, se proporciona un ejemplo de gestión de eventos de mantenimiento mediante un proceso de mantenimiento completo mediante la CLI.

Fase de detección

Identifique los próximos eventos de mantenimiento de instancias.

Mostrar eventos de mantenimiento

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

Sustituya <compartment-id> por el OCID del compartimento.

Ejemplo:

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

Salida de ejemplo:

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

Obtener detalles de evento de mantenimiento de instancia

Consulta de un evento de mantenimiento específico.

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

Sustituya <instance-maintenance-event-id> por el OCID del evento específico.

Ejemplo:

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

Salida de ejemplo:

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

Fase de mantenimiento previo

Reprograme la ventana de hora de inicio de un evento de mantenimiento de instancias y realice las acciones de mantenimiento previas necesarias.

Reprogramar evento de mantenimiento de instancia

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

Sustituya <instance-maintenance-event-id> por el OCID del evento y <time-window-start> por la hora de inicio deseada en formato ISO 8601.

Ejemplo:

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"

Salida de ejemplo:

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

Asegúrese de que todas las acciones de mantenimiento previo se completen antes de la ventana de hora de inicio programada.

Fase de supervisión

El mantenimiento comienza a la hora programada de inicio. Espere hasta que finalice el mantenimiento.

Supervisar estado de evento de mantenimiento de instancia

Supervisar el estado de un evento de mantenimiento durante la ejecución.

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

Sustituya <instance-maintenance-event-id> por el OCID del evento.

Ejemplo:

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

Salida de ejemplo:

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

Fase posterior al mantenimiento

Puede realizar su propia acción posterior al mantenimiento, si la hay, después de que finalicen los eventos de mantenimiento de instancias.