Oracle Cloud Infrastructureドキュメント

非終了修理

OCIのNon-Terminating Repair(NTR)により、実行中のインスタンスを終了または退避することなく、基礎となるハードウェアまたはソフトウェア・コンポーネントのメンテナンスと修復が可能になります。

重要

NTRは、ベア・メタル・シェイプでのみサポートされています。

この方法は、メンテナンスを続行する前にインスタンスの終了を必要とする従来の終了修復(TR)方法と対照的です。NTRは、サービスの中断を最小限に抑え、OCI上のアプリケーションの可用性を高めます。NTRには、次のメンテナンス・タイプが含まれます。

  • 停止時間の修復:インスタンスはメンテナンスの前に停止されます。このプロセスでは、保守中にホストをシャットダウンまたはリブートする必要があります。
    • インスタンス・アクション: STOP
  • ライブ修復:インスタンスが稼働している間にメンテナンスが発生します。インスタンスは稼働状態のままであり、メンテナンス中に終了や電源切断は必要ありません。
    • インスタンス・アクション: NONE
  • ライブ・バックグラウンド修復:ユーザー・アクションが不要で、OCIがメンテナンス・イベントを作成し、バックグラウンドで修復を実行するユース・ケース。
    • インスタンス・アクション: NONE
重要

メンテナンス開始: スケジュールされた開始時間ウィンドウに達すると、NTRメンテナンスが開始されます。メンテナンスの開始に必要な時間にメンテナンスをスケジュールします。

メンテナンス・イベント

OCIは、インフラストラクチャ・メンテナンス・プロセスを管理するためのメンテナンス・イベントを提供します。

メンテナンス・イベントは、インスタンス/ホストにメンテナンスが必要なときに作成されます。イベントは、インスタンスに影響する今後のメンテナンス・アクティビティをユーザーに通知します。メンテナンス・イベントは、OCIコンソールのインスタンス・メンテナンス・リソースに表示されます。また、メンテナンス・イベントはCLIまたはSDKを使用して管理できます。すべてのインタフェースにより、ユーザーはメンテナンス・ウィンドウの再スケジュール、メンテナンスの進捗の監視、および必要なメンテナンス前またはメンテナンス後のアクションを実行できます。

たとえば、次のリンクは、Pythonで定義されたメンテナンス・イベント・クラスの例を示しています。InstanceMaintenanceEvent: https://docs.oracle.com/iaas/tools/python/latest/api/core/models/oci.core.models.InstanceMaintenanceEvent.html.

修理の終了

従来、修復の終了(TR)は、OCIがインスタンスの基礎となるハードウェアまたはソフトウェアで修復を実行するための唯一の方法です。

このプロセスでは、修復を開始する前に、影響を受けるインスタンスの退避および終了が必要です。TRメンテナンスは、顧客がインスタンスを終了すると開始されます。その後、メンテナンスを再スケジュールすることなくメンテナンスが実行されます。

CLIを使用したNTRイベントの管理

次のステップでは、CLIを使用したメンテナンス・プロセス全体でのメンテナンス・イベントの管理の例を示します。

検出フェーズ

今後のインスタンス・メンテナンス・イベントを識別します。

保守イベントのリスト

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

<compartment-id>をコンパートメントのOCIDに置き換えます。

例:

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

出力例:

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

インスタンス保守イベント詳細の取得

特定のメンテナンス・イベントを表示します。

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

<instance-maintenance-event-id>を特定のイベントのOCIDに置き換えます。

例:

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

出力例:

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

保守前フェーズ

インスタンス・メンテナンス・イベントの開始時間ウィンドウを再スケジュールし、必要なメンテナンス前アクションを実行します。

インスタンス保守イベントの再スケジュール

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

<instance-maintenance-event-id>をイベントのOCIDに、<time-window-start>をISO 8601形式の必要な開始時間に置き換えます。

例:

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"

出力例:

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

スケジュールされた開始時間ウィンドウの前に、すべてのメンテナンス前アクションが完了していることを確認してください。

モニター・フェーズ

メンテナンスは、スケジュールされた開始時間に開始されます。メンテナンスが完了するまでお待ちください。

インスタンス保守イベント・ステータスのモニター

実行中のメンテナンス・イベントのステータスをモニターします。

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

<instance-maintenance-event-id>をイベントのOCIDに置き換えます。

例:

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

出力例:

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

メンテナンス後のフェーズ

インスタンスのメンテナンス・イベントの完了後に、メンテナンス後のアクション(存在する場合)を独自に実行できます。