Instanzattribute aktualisieren

Sie können eine einzelne Anfrage über die Google Cloud CLI oder die Compute Engine API verwenden, um mehrere Instanzattribute zu aktualisieren und die Instanz bei Bedarf optional neu zu starten. Die Aktualisierungsmethode verarbeitet die Logik zur Validierung der aktualisierten Instanzattribute und sorgt dafür, dass die erforderlichen Ressourcen verfügbar sind, um die Aktualisierung erfolgreich abzuschließen. Wenn die Anfrage ungültige Attribute enthält oder die angeforderten Ressourcen nicht verfügbar sind, gibt die Anfrage einen Fehler zurück und nimmt keine Änderungen an Ihrer Instanz vor. Dadurch wird die Instanz vor Teilaktualisierungen geschützt und es wird verhindert, dass die Instanz gestoppt wird und nicht wieder auf für einen Neustart nötige Ressourcen zugreifen kann.

Informationen zum Aktualisieren der Netzwerkschnittstellen (networkInterfaces) einer Instanz finden Sie unter Netzwerkschnittstellen einer Instanz aktualisieren.

Wenn Sie Dynamic Network Interfaces zu einer Instanz hinzufügen oder daraus entfernen möchten, verwenden Sie die folgenden Verfahren, anstatt die Instanzattribute zu aktualisieren:

• Dynamische NICs aus einer Instanz löschen
• Dynamic NICs zu einer Instanz hinzufügen

Hinweis

• Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Cloud de Confiance 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:

  Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:

  Console

  Wenn Sie über die Cloud de Confiance Console auf Cloud de Confiance by S3NS -Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

  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 dem folgenden Befehl:

     gcloud init

• Legen Sie eine Standardregion und -zone fest.

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.

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

Beschränkungen

• Anfragen zur Instanzaktualisierung mit der gcloud CLI oder der Compute Engine API unterstützen keine PATCH-Semantik. Die Instanzressource in der Aktualisierungsanfrage muss alle Attribute der Instanz enthalten. Attribute, die in der Instanzkonfiguration der Aktualisierungsanfrage fehlen, werden als von der Instanz gelöscht betrachtet.
• Sie können nur bestimmte Liste von Attributen aktualisieren.
• Wenn an die Instanz lokale SSDs angehängt sind, können Sie keine Attribute aktualisieren, für die die Instanz neu gestartet werden muss, während die Instanz ausgeführt wird. Sie können die Instanz löschen und dann neu erstellen oder die Instanz beenden, die Attribute aktualisieren und die Instanz dann neu starten.
• Sie können das Attribut networkInterfaces einer Instanz aktualisieren, aber keine virtuellen Netzwerkkarten (vNICs) hinzufügen oder entfernen.
• Wenn eine Instanz Ressourcen verwendet, die nur in der Betaversion der Compute Engine API verfügbar sind, müssen Sie diese Attribute mit der richtigen Version der Methode instances.update aktualisieren. Wenn Sie zum Beispiel eine Instanz mit der Beta Compute Engine API erstellen und die Instanz mit einer Ressource konfigurieren, die nur die Betaversion der API erkennt, müssen Sie diese Ressourcen auch mit der Betaversion der Methode instances.update aktualisieren. Die v1-Version der Methode instances.update erkennt die Betaressourcen, die von Ihrer Instanz verwendet werden, nicht. Daher werden diese Betaressourcen während des Aktualisierungsprozesses aus der Instanzkonfiguration gelöscht. Dieses Verhalten gilt auch für Ressourcen in der Alpha-API.

Berechtigungen

Zum Aktualisieren von Instanzen benötigen Sie die Berechtigung compute.instances.update. Diese Berechtigung ist in mehreren vorhandenen IAM-Rollen (Identity and Access Management, Identitäts- und Zugriffsverwaltung) enthalten. Sie benötigen außerdem die Berechtigung, die Ressourcen zu verwenden, die Sie auf der Instanz ändern möchten. Wenn Sie einer Instanz beispielsweise ein Laufwerk hinzufügen möchten, benötigen Sie die folgenden Berechtigungen:

• Die Berechtigung compute.instances.update für die Instanz, die Sie aktualisieren möchten.
• Entweder die Berechtigung compute.disks.use für ein vorhandenes Laufwerk oder compute.disks.create für ein Projekt, in dem Sie ein neues Laufwerk erstellen möchten.

Best Practices

Achten Sie auf die folgenden Best Practices, damit die Schnittstelle zur Instanzaktualisierung so effektiv wie möglich funktioniert:

• Verwenden Sie nach Möglichkeit immer dieselbe Version der Compute Engine API, um Instanzen zu erstellen, festzulegen und zu aktualisieren. Dadurch wird sichergestellt, dass Sie alle Instanzressourcen aktualisieren und ändern können, wenn sie nur in einer Version der API verfügbar sind.
• Sie können die Methode instances.update auch zum Aktualisieren von Instanzen in einer verwalteten Instanzgruppe verwenden. In den meisten Fällen ist es jedoch besser, stattdessen die Instanzvorlage der Gruppe zu ändern und dieses Update auf die verwaltete Instanzgruppe anzuwenden.
• Wenn Sie eine Ressource aktualisieren, die von der Instanz verwendet wird, verwenden Sie den Befehl zum Aktualisieren dieser Ressourceninstanz anstelle der Instanzeigenschaften, z. B.:
  • Sie können Laufwerke mit der Methode disks.update ändern.
  • Wenn Sie das von der Instanz verwendete Netzwerk ändern möchten, können Sie die Methode instances.updateNetworkInterface verwenden. Dazu muss die Instanz nicht beendet werden.

Attribute, die aktualisiert werden können

Sie können mit der Aktualisierungsmethode nur bestimmte Instanzattribute ändern. Für die Aktualisierung einiger Attribute muss die Instanz neu gestartet werden. Damit versehentliche Neustarts der Instanzen verhindert werden, muss in der Anfrage festgelegt sein, welche Aktion für Ihre Instanzen zulässig ist. Sie können in der Anfrage eine der folgenden Aktionen angeben:

• NO_EFFECT: Bei der Aktualisierungsanfrage wird geprüft, ob die Anfrage gültig ist und ob die Ressourcen verfügbar sind. Die Aktualisierung wird jedoch nicht ausgeführt. Verwenden Sie diese Aktion, um Befehle zu testen, ohne tatsächliche Aktualisierungen zu starten.
• REFRESH: Die Aktualisierungsanfrage wird nur ausgeführt, wenn für die geänderten Instanzeigenschaften kein Neustart der Instanz erforderlich ist. Die Anfrage gibt den Fehler INFEASIBLE zurück, wenn die Anfrage gültig ist, aber ein Neustart erforderlich ist.
• RESTART: Wenn für das Update ein Neustart der Instanz erforderlich ist, wird die Instanz vom System neu gestartet.

Für die Aktualisierung der folgenden Attribute ist ein Neustart (RESTART) erforderlich:

• disks: Bootlaufwerke, einschließlich aller Laufwerke (disks.deviceName)
• displayDevice
• enableNestedVirtualization
• guestAccelerators
• machineType
• minCpuPlatform
• networkInterfaces
• networkPerformanceConfig
• performanceMonitoringUnit
• reservationAffinity: Sie können die Art und Weise, wie die Instanz Reservierungen (reservationAffinity.consumeReservationType) nutzt, nur so aktualisieren:
  • Von der Nutzung jeder übereinstimmenden Reservierung (ANY_RESERVATION) bis zur Nichtnutzung von Reservierungen (NO_RESERVATION)
  • Von „Keine Reservierungen nutzen“ (NO_RESERVATION) zu „Alle übereinstimmenden Reservierungen nutzen“ (ANY_RESERVATION)
• resourcePolicies
• scheduling
• serviceAccounts
• shieldedInstanceConfig
• threadsPerCore
• visibleCoreCount

Für die Aktualisierung der folgenden Attribute ist nur eine Aktualisierung (REFRESH) erforderlich:

• canIpForward
• deletionProtection
• description
• disks: Attribute des Nicht-Bootlaufwerks, mit Ausnahme von deviceName
• labels
• metadata
• nodeAffinities
• tags

Instanzattribute aktualisieren

Führen Sie die folgenden Schritte aus, um Ihre Instanz zu aktualisieren:

1. Exportieren Sie die vorhandenen Instanzkonfigurationsattribute.
2. Ändern Sie die Attribute der Instanzkonfiguration.
3. Führen Sie eine Testanfrage aus, indem Sie die umfangreichste Aktion NO_EFFECT angeben. In der Antwort sind ungültige Felder in der Instanzkonfiguration sowie die Aktion angegeben, die zum Anwenden der Änderungen erforderlich ist.
4. Wenn die Konfiguration akzeptabel ist, fordern Sie eine Instanzaktualisierung an und geben Sie die umfangreichste Aktion an, die für Ihr Instanzupdate akzeptabel ist.

Der Aktualisierungsvorgang wird nur dann gestartet, wenn Ihre Anfrage die folgenden Anforderungen erfüllt:

• Das Instanzattribut fingerprint in Ihrer Anfrage muss mit dem fingerprint der Instanz übereinstimmen, die Sie aktualisieren möchten. Dadurch wird verhindert, dass Aktualisierungsanfragen durch andere gleichzeitige für dieselbe Instanz überschrieben werden.
• Die Attribute in Ihrer Aktualisierungsanfrage müssen gültig sein.
• Die angeforderten Ressourcen müssen verfügbar sein.
• Wenn für die Attribute in Ihrer Anfrage die Instanz neu gestartet werden muss, muss in der Anfrage RESTART als zulässige Aktion angegeben sein.

Wenn die Anforderungen erfüllt sind, startet das System den Instanzaktualisierungsvorgang. Andernfalls nimmt das System keine Änderungen an der vorhandenen Instanz oder der zugehörigen Konfiguration vor.

Sie können Aktualisierungen entweder mit der gcloud CLI oder der Compute Engine API initiieren.

Nächste Schritte

• Prüfen Sie den Status der Instanz.
• Ressourcen in einer bestimmten Zone reservieren
• Netzwerkschnittstellen für eine Instanz aktualisieren