Documentação do Oracle Cloud Infrastructure

Reparo sem encerramento

O Reparo sem Encerramento (NTR) na OCI permite a manutenção e o reparo de componentes de hardware ou software subjacentes sem a necessidade de encerrar ou evacuar instâncias em execução.

Importante

O NTR só é suportado em formas bare metal.

Essa abordagem contrasta com os métodos tradicionais de Reparo de Encerramento (TR), que exigem o encerramento da instância antes da continuação da manutenção. O NTR minimiza interrupções de serviço e aumenta a disponibilidade de aplicativos na OCI. O NTR engloba os seguintes tipos de manutenção:

  • Reparos de tempo de inatividade: As instâncias são interrompidas antes da manutenção. O processo requer que o host seja encerrado ou reinicializado durante a manutenção.
    • Ação da Instância: STOP
  • Reparos ao vivo: A manutenção ocorre enquanto as instâncias permanecem operacionais. As instâncias permanecem em um estado de execução, sem necessidade de desligamento ou desligamento durante a manutenção.
    • Ação da Instância: NONE
  • Reparo em segundo plano ao vivo: Um caso de uso em que nenhuma ação do usuário é necessária e a OCI cria um evento de manutenção e executa o reparo em segundo plano.
    • Ação da Instância: NONE
Importante

Iniciação de Manutenção: A manutenção de NTR começa quando o intervalo de horário inicial programado é atingido. Programe a manutenção no horário desejado para o início da manutenção.

Eventos de Manutenção

A OCI fornece eventos de manutenção para gerenciar processos de manutenção de infraestrutura.

Os eventos de manutenção são criados quando sua instância/host precisa de manutenção. Os eventos notificam os usuários sobre as próximas atividades de manutenção que afetam suas instâncias. Os eventos de manutenção aparecem no recurso de Manutenção de Instâncias na Console do OCI. Além disso, os eventos de manutenção podem ser gerenciados usando a CLI ou SDKs. Todas as interfaces permitem que os usuários reprogramem janelas de manutenção, monitorem o andamento da manutenção e executem as ações necessárias de pré-manutenção ou pós-manutenção.

Por exemplo, o link a seguir fornece um exemplo de classe de evento de manutenção definida no Python. InstanceMaintenanceEvent: https://docs.oracle.com/iaas/tools/python/latest/api/core/models/oci.core.models.InstanceMaintenanceEvent.html.

Encerrando Reparo

Historicamente, Terminar Reparo (TR) é o único método para a OCI executar reparos no hardware ou software subjacente de uma instância.

Este processo requer evacuação e encerramento da instância afetada antes do início dos reparos. A manutenção do TR começa quando o cliente encerra a ocorrência. Em seguida, a manutenção ocorre sem precisar reprogramar a manutenção.

Gerenciando Eventos NTR com a CLI

As etapas a seguir fornecem um exemplo de gerenciamento de eventos de manutenção por meio de todo um processo de manutenção usando a CLI.

Descobrir Fase

Identifique os próximos Eventos de Manutenção de Instância.

Listar Eventos de Manutenção

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

Substitua <compartment-id> pelo OCID do seu compartimento.

Exemplo:

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

Exemplo de saída:

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

Obter Detalhes do Evento de Manutenção da Instância

Visualizar um evento de manutenção específico.

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

Substitua <instance-maintenance-event-id> pelo OCID do evento específico.

Exemplo:

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

Exemplo de saída:

{
  "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 Pré-Manutenção

Reprogramar a janela de horário inicial de um Evento de Manutenção da Instância e executar as ações de pré-manutenção necessárias.

Reprogramar Evento de Manutenção da Instância

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

Substitua <instance-maintenance-event-id> pelo OCID do evento e <time-window-start> pelo horário inicial desejado no formato ISO 8601.

Exemplo:

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"

Exemplo de saída:

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

Certifique-se de que todas as ações de pré-manutenção sejam concluídas antes da janela de horário inicial programada.

Monitorar Fase

A manutenção começa no horário inicial programado. Aguarde até que a manutenção seja concluída.

Monitorar Status do Evento de Manutenção da Instância

Monitorar o status de um evento de manutenção durante a execução.

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

Substitua <instance-maintenance-event-id> pelo OCID do evento.

Exemplo:

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

Exemplo de saída:

{
  "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 de pós-manutenção

Você pode executar sua própria ação de pós-manutenção, se houver alguma, após a conclusão dos Eventos de Manutenção da Instância.