ライセンスの表示と追加を行う

このドキュメントでは、仮想マシン（VM）インスタンスに関連付けられているライセンスの表示、VM へのライセンスの追加、ライセンスの更新履歴の表示を行う方法について説明します。Compute Engine のライセンスの詳細については、ライセンスについてをご覧ください。

始める前に

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

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

  Console

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

  gcloud

  1. After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

  After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:

  gcloud init

  詳細については、 Trusted Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

VM に関連付けられているライセンスを表示する

VM に関連付けられているライセンスを表示するには、 Trusted Cloud コンソール、gcloud CLI、または Compute Engine API を使用します。

VM に関連付けられているユーザー ライセンスを表示する

VM に関連付けられているユーザー ライセンスを表示するには、Trusted Cloud コンソール、gcloud CLI、または Compute Engine API を使用します。

画像のインポート時にライセンスを追加する

画像のインポート時にライセンスを追加するには、次の gcloud compute images import コマンドを使用します。

gcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE
  --os=OS

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

• IMAGE_NAME: 作成するイメージの名前。
• SOURCE_FILE: インポートする仮想ディスクのローカル ファイルまたは Cloud Storage URI。
• OS: インポートするディスク イメージの OS。OS のライセンスは、このフラグの値から推定されます。インポート時にライセンス情報を提供するための明示的なフラグはありません。サポートされている値の一覧については、--os フラグをご覧ください。

イメージのインポートの詳細については、仮想ディスクのインポートをご覧ください。

イメージの作成時にライセンスを追加する

イメージの作成時にライセンスを追加するには、次の gcloud compute images create コマンドを使用します。

gcloud compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES

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

• IMAGE_NAME: 作成するイメージの名前。
• SOURCE_IMAGE: 新しいイメージの作成元であるイメージの名前。
• LICENSES: ライセンス文字列のカンマ区切りリスト。例えば、"license1"、"license2"。

イメージの作成の詳細については、カスタム イメージの作成、削除、サポート終了と Windows イメージの作成をご覧ください。

イメージの作成時にライセンスとユーザー ライセンスを追加する

イメージの作成時にライセンスとユーザー ライセンスを追加するには、次の gcloud beta compute images create コマンドを使用します。

gcloud beta compute images create IMAGE_NAME \
  --source-image=SOURCE_IMAGE \
  --licenses=LICENSES \
  --user-licenses=USER_LICENSES

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

• IMAGE_NAME: 作成するイメージの名前。
• SOURCE_IMAGE: 新しいイメージの作成元であるイメージの名前。
• LICENSES: ライセンス文字列のカンマ区切りリスト。例えば、"license1"、"license2"。
• USER_LICENSES: ユーザー ライセンス文字列のカンマ区切りリスト。例えば、"userlicense1"、"userlicense2"。

イメージの作成の詳細については、カスタム イメージの作成、削除、サポート終了と Windows イメージの作成をご覧ください。

ユーザー ライセンスを追加して検証する

ユーザー ライセンスを追加して検証する方法は次のとおりです。

1. VM を停止します。

2. gcloud compute instances describe コマンドを使用して、VM に関連付けられたディスクの一覧を表示します。

   gcloud compute instances describe VM_NAME --format="yaml(disks)"
   

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

   disks:
   - autoDelete: true
     boot: true
     deviceName: BOOT_DISK_NAME
     diskSizeGb: '20'
     guestOsFeatures:
     - type: UEFI_COMPATIBLE
     index: 0
     interface: SCSI
     kind: compute#attachedDisk
     licenses:
     - BOOT_DISK_LICENSE_STRING
     mode: READ_WRITE
     source: https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/disks/BOOT_DISK_NAME
     type: PERSISTENT
   

4. 前の手順の出力で、ブートディスクの名前を確認します。ブートディスクの場合、boot の値は true で、ブートディスクの名前は deviceName になっています。

5. gcloud beta compute disks update コマンドを使用して、ユーザー ライセンスをブートディスクに追加します。

   gcloud beta compute disks update BOOT_DISK_NAME \
      --update-user-licenses=LICENSE_URIS
   

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

   • BOOT_DISK_NAME: ライセンスを追加するブートディスクの名前。

   • LICENSE_URIS: ライセンス文字列のカンマ区切りのリスト。既存のユーザー ライセンスがすべて置き換えられます。

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

   gcloud beta compute disks describe BOOT_DISK_NAME
   

   BOOT_DISK_NAME をブートディスクの名前に置き換えて、付加されたライセンスを確認します。

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

   creationTimestamp: '2021-05-05T15:26:27.835-07:00'
   guestOsFeatures:
   - type: UEFI_COMPATIBLE
   id: '727854272460268924'
   interface: SCSI
   kind: compute#disk
   labelFingerprint: 42WmSpB8rSM=
   lastAttachTimestamp: '2021-05-05T15:26:27.836-07:00'
   licenseCodes:
   - '1000006'
   - '6213885950785916969'
   licenses:
   - BOOT_DISK_LICENSE_STRING
   multiWriter: false
   name: VM_NAME
   physicalBlockSizeBytes: '4096'
   selfLink: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/DISK_NAME
   selfLinkWithId: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/disks/727854272460268924
   sizeGb: '20'
   sourceImage: https://www.googleapis.com/compute/beta/projects/IMAGE_PROJECT/global/images/IMAGE
   sourceImageId: '7397991294075835597'
   status: READY
   type: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/diskTypes/pd-standard
   userLicenses:
   - LICENSE_URI
   users:
   - https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
   zone: https://www.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE
   

8. 前の手順の出力で、適切なライセンス文字列の userLicenses フィールドを調べて、ユーザー ライセンスがブートディスクに追加されていることを確認します。

   userLicenses フィールドに目的のライセンス文字列が含まれていない場合は、ライセンス文字列のリストをクリアしてから更新する必要があります。これを行うには、gcloud beta compute disks update コマンドを使用します。

9. VM を起動します。

ライセンス更新の履歴を表示する

次の手順を使用して、プロジェクト内の VM のライセンス更新履歴を表示します。

1. Trusted Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

   [ログ エクスプローラ] に移動

2. ツールバーで [クエリを表示] が有効になっていることを確認します。

3. 次の式をクエリエディタにコピーします。

   resource.type="gce_disk"
   logName="projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Factivity"
   severity>=NOTICE
   protoPayload.request.@type="type.googleapis.com/compute.disks.update"
   protoPayload.request.userLicenses:*
   

4. [クエリを実行] をクリックします。

次のステップ

• ライセンスのトラブルシューティング

• Compute Engine の Microsoft ライセンスについて確認する

• プレミアム オペレーティング システムについて確認する

  • RHEL に関するよくある質問を参照する

  • SLES に関するよくある質問を参照する

  • Ubuntu Pro に関するよくある質問を参照する