OS のアップグレード後にライセンスを更新する

このページでは、オペレーティング システム（OS）のインプレース アップグレードを実行した後に、仮想マシン（VM）インスタンスのライセンス文字列を更新する方法について説明します。このプロセスは、次のオペレーティング システムに適用されます。

  • Red Hat Enterprise Linux（RHEL）
  • RHEL for SAP
  • SUSE Linux Enterprise Server（SLES）
  • SLES for SAP
  • Windows Server

ライセンス参照とコードの詳細については、ライセンスの変更と制限事項をご覧ください。

始める前に

  • まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。 

      gcloud init

      外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

    2. Set a default region and zone.

ディスクのライセンス更新の準備をする

ディスクが実行中のインスタンスにアタッチされている間にディスクのライセンスを更新するには、まずインスタンスを停止するか、ディスクを切断します。

  • インスタンスを停止します。ディスクのライセンスを更新する前に、インスタンスを一時的にシャットダウンします。
  • ディスクを切断します。これにより、ディスクのライセンスを更新する前に、ディスクがインスタンスから切断されます。

ディスクのライセンスを更新する

ディスクのライセンスを更新するには、Google Cloud CLI または Compute Engine API を使用します。このプロセスでは、既存のライセンス URI がアップグレードされた OS バージョンに対応する新しい URI に置き換えられます。

gcloud

ディスクのライセンスを新しいライセンス参照に置き換えるには、gcloud compute disks update コマンドを使用します。

gcloud compute disks update DISK_NAME \
    --replace-license=PREVIOUS_LICENSE,NEW_LICENSE

次のように置き換えます。

  • DISK_NAME: 更新するディスクの名前。
  • PREVIOUS_LICENSE: 以前の OS バージョンに必要なライセンス参照（"windows-server-2022-dc"、"rhel-9" など）。
  • NEW_LICENSE: 新しい OS バージョンに必要なライセンス参照（"windows-server-2025-dc"、"rhel-10" など）。

REST

ディスクのライセンスを置き換えるには、新しいライセンスをリクエスト本文に追加し、以前のライセンスを省略します。次の disks.update v1 メソッドを呼び出します。

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks/DISK_NAME?paths=licenses --data '{"name":"DISK_NAME", "licenses":["https://www.googleapis.com/compute/v1/NEW_LICENSE"]}'

次のように置き換えます。

  • PROJECT: プロジェクトの名前。
  • ZONE: ディスクを含むゾーン。
  • DISK_NAME: ディスクの名前。
  • NEW_LICENSE: 新しいライセンス参照（"windows-server-2025-dc"、"rhel-10" など）。

ライセンスの変更を検証する

ブートディスクのライセンスが変更されたことを検証するには、次の手順を行います。

  1. gcloud compute disks describe コマンドを実行して、ブートディスクに関する情報を取得します。

    gcloud compute disks describe DISK_NAME \
    --zone=ZONE \
    --format="value(licenses)"

    次のように置き換えます。

    • DISK_NAME: ライセンスを検証するブートディスクの名前
    • ZONE: ライセンスを検証するブートディスクを含むゾーン

  2. 次のような内容が出力されていることを確認します。

    https://www.googleapis.com/compute/v1/projects/windows-cloud/global/licenses/windows-server-2025-dc