Lizenzen verwalten

In diesem Dokument wird beschrieben, wie Sie Lizenzen verwalten, die mit einer Compute Engine-Instanz verknüpft sind. Dazu gehört auch, wie Sie Lizenzen anhängen, entfernen und ersetzen und den Verlauf von Lizenzaktualisierungen ansehen. Weitere Informationen zu Lizenzen in Compute Engine finden Sie unter Informationen zu Lizenzen.

Einschränkungen für die Verwaltung von Lizenzen:

  • Sie können einem Laufwerk nur dann eine Lizenz hinzufügen, wenn AppendableToDisk true ist.
  • Sie können nur entfernen (ohne Ersatz), wenn RemovableFromDisk true ist.
  • Sie können eine Lizenz nur durch eine der in AllowedReplacementLicenses aufgeführten Ersatzlizenzen ersetzen.

Informationen zum Upgrade Ihrer Lizenz auf Ubuntu Pro, um die erweiterte Sicherheitswartung (Extended Security Maintenance, ESM) für Ubuntu LTS zu aktivieren, finden Sie unter Upgrade von Ubuntu auf Ubuntu Pro.

Informationen zum Aktualisieren Ihrer On-Demand-RHEL-Lizenz, um erweiterten Support einzuschließen, finden Sie unter RHEL-ELS-Add-on (Extended Lifecycle Support) an Ihre Lizenz anhängen.

Hinweise

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Trusted Cloud by S3NS -Dienste und APIs überprüft. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:

    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. Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit folgendem Befehl:

      gcloud init
    2. Set a default region and zone.

    REST

    Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

      Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit folgendem Befehl:

      gcloud init

    Weitere Informationen finden Sie in der Dokumentation zur Trusted Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Vorbereiten des Aktualisierens der Lizenz eines Laufwerks

Wenn Sie die Lizenz des Laufwerks aktualisieren möchten, während das Laufwerk an eine laufende Instanz angehängt ist, müssen Sie zuerst die Instanz beenden oder das Laufwerk trennen.

  • Beenden Sie die Instanz. Fährt die Instanz vorübergehend herunter, bevor die Lizenz des Laufwerks aktualisiert wird.
  • Trennen Sie das Laufwerk. Dadurch wird das Laufwerk von der Instanz getrennt, bevor die Lizenz des Laufwerks aktualisiert wird.

Mit einer VM verknüpfte Lizenzen ansehen

Zum Aufrufen der mit einer VM verknüpften Lizenzen verwenden Sie die Trusted Cloud Console, die gcloud CLI oder die Compute Engine API.

Console

  1. Rufen Sie in der Trusted Cloud Console die Seite VM-Instanzen auf:

    Zu "VM-Instanzen"

  2. Klicken Sie auf den Namen der VM, von der die Lizenz geprüft werden soll. Die Seite Instanzdetails wird geöffnet.

  3. Klicken Sie unten auf der Seite Instanzdetails auf Entsprechender Code.

  4. Sehen Sie sich das Feld licenses für das Bootlaufwerk an.

gcloud

  1. Führen Sie dazu diesen Befehl gcloud compute instances describe aus:

    gcloud compute instances describe VM_NAME
    

    Ersetzen Sie VM_NAME durch den Namen Ihrer VM.

  2. Sehen Sie sich den Abschnitt disks der Ausgabe an. Das Feld licenses zeigt die mit dem Bootlaufwerk verknüpften Lizenzen an.

REST

Rufen Sie die instances.get v1-Methode auf:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instancesVM_NAME

Ersetzen Sie Folgendes:

  • PROJECT ist der Name des Projekts.
  • ZONE ist die Zone mit der VM.
  • VM_NAME: Der Name der VM

Die Compute Engine API gibt die mit dem Bootlaufwerk verknüpften Lizenzen im Abschnitt disks des Felds licenses zurück.

Lizenz beim Importieren eines Images anhängen

Mit dem folgenden gcloud compute images import-Befehl können Sie eine Lizenz während des Image-Imports anhängen.

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

Ersetzen Sie Folgendes:

  • IMAGE_NAME ist der Name des zu erstellenden Images.
  • SOURCE_FILE ist eine lokale Datei oder ein Cloud Storage-URI des zu importierenden virtuellen Laufwerks.
  • OS ist das Betriebssystem des zu importierenden Laufwerk-Images. Die Lizenz für das Betriebssystem wird aus dem Wert dieses Flags abgeleitet. Es gibt kein explizites Flag, um beim Import Lizenzinformationen bereitzustellen. Eine Liste der unterstützten Werte finden Sie unter Flag --os.

Weitere Informationen zum Importieren von Images finden Sie unter Virtuelle Laufwerke importieren.

Lizenzen beim Erstellen eines Images anhängen

Verwenden Sie den folgenden gcloud compute images create-Befehl, um beim Erstellen eines Images Lizenzen anzuhängen.

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

Ersetzen Sie dabei Folgendes:

  • IMAGE_NAME ist der Name des zu erstellenden Images.
  • SOURCE_IMAGE ist der Name des Images, aus dem das neue Image erstellt werden soll.
  • LICENSES: eine durch Kommas getrennte Liste von Lizenzstrings. Beispiel: "license1", "license2".

Weitere Informationen zum Erstellen von Images finden Sie unter Benutzerdefinierte Images erstellen, löschen und verwerfen und Windows-Images erstellen.

Weitere Informationen zum Erstellen von Images finden Sie unter Benutzerdefinierte Images erstellen, löschen und verwerfen und Windows-Images erstellen.

Lizenzen an ein Laufwerk anhängen

Verwenden Sie die gcloud CLI oder die Compute Engine API, um einer VM zugeordnete Lizenzen anzuhängen.

gcloud

Verwenden Sie den folgenden gcloud compute disks update-Befehl, um Lizenzen mithilfe einer Lizenzreferenz oder eines Lizenzcodes an ein Laufwerk anzuhängen.

gcloud compute disks update DISK_NAME \
--append-licenses=LICENSES

Ersetzen Sie Folgendes:

  • DISK_NAME: der Name des anzuhängenden Laufwerks.
  • LICENSES: eine durch Kommas getrennte Liste von Lizenzreferenzen, z. B. "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Wenn Sie Lizenzen mithilfe einer Lizenzreferenz oder eines Lizenzcodes an ein Laufwerk anhängen möchten, rufen Sie die folgende disks.update-Methode v1 auf:

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/LICENSES"]}'

Ersetzen Sie Folgendes:

  • PROJECT ist der Name des Projekts.
  • ZONE ist die Zone mit der VM.
  • DISK_NAME: Name des Laufwerks
  • LICENSES: eine durch Kommas getrennte Liste von Lizenzreferenzen, z. B. "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Lizenzen auf einem Datenträger ersetzen

Verwenden Sie die gcloud CLI oder die Compute Engine API, um Lizenzen zu ersetzen, die mit einer VM verknüpft sind.

gcloud

Wenn Sie eine Lizenz auf einer Festplatte durch eine Lizenzreferenz oder einen Lizenzcode ersetzen möchten, verwenden Sie den folgenden gcloud compute disks update-Befehl.

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

Ersetzen Sie Folgendes:

  • DISK_NAME: der Name des anzuhängenden Laufwerks.
  • PREVIOUS_LICENSE: Die vorherige Lizenzreferenz, die ersetzt wird, z. B. "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".
  • NEW_LICENSE: die neue Lizenzreferenz, z. B. "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Wenn Sie eine Lizenz auf einem Laufwerk mithilfe einer Lizenzreferenz oder eines Lizenzcodes ersetzen möchten, rufen Sie die disks.update-Methode v1 auf und ersetzen Sie die vorherige Lizenz im Anfragetext durch die neue Lizenz:

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

Ersetzen Sie Folgendes:

  • PROJECT ist der Name des Projekts.
  • ZONE ist die Zone mit der VM.
  • DISK_NAME: Name des Laufwerks
  • NEW_LICENSE: die neue Lizenzreferenz, z. B. "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

Lizenzen von einem Laufwerk entfernen

Verwenden Sie die gcloud CLI und die Compute Engine API, um einzelne Lizenzen zu entfernen, die mit einer VM verknüpft sind.

gcloud

Verwenden Sie den Befehl gcloud compute disks update, um Lizenzen von einer Festplatte mit einer Lizenzreferenz oder einem Lizenzcode zu entfernen.

gcloud compute disks update DISK_NAME \
--remove-licenses=LICENSES

Ersetzen Sie Folgendes:

  • DISK_NAME: der Name des Laufwerks, das entfernt werden soll.
  • LICENSES: eine durch Kommas getrennte Liste von Lizenzreferenzen, z. B. "projects/rhel-cloud/global/licenses/rhel-9-server", "projects/rhel-cloud/global/licenses/rhel-8-server".

REST

Wenn Sie eine Lizenz entfernen möchten, geben Sie im Aufruf zusammen mit der Pfadauswahl ein leeres Lizenzfeld an, indem Sie die folgende disks.update v1-Methode aufrufen:

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

Ersetzen Sie Folgendes:

  • PROJECT ist der Name des Projekts.
  • ZONE ist die Zone mit der VM.
  • DISK_NAME: Name des Laufwerks
  • LICENSES: Lassen Sie das Feld leer.

Verlauf der Lizenzaktualisierungen ansehen

Rufen Sie mit dem folgenden Verfahren den Verlauf der Lizenzaktualisierungen für VMs in einem Projekt auf:

  1. Rufen Sie in der Trusted Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

  2. Prüfen Sie in der Symbolleiste, ob Abfrage anzeigen aktiviert ist.

  3. Kopieren Sie den folgenden Ausdruck in den Abfrageeditor:

    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.licenses:*
    
  4. Ersetzen Sie PROJECT_NAME durch den Namen des Projekts.

  5. Klicken Sie auf Abfrage ausführen.

Nächste Schritte