Instanz mit IPv6-Adressen erstellen


Compute Engine-Instanzen werden standardmäßig mit IPv4-Adressen erstellt. Optional können Sie Compute-Instanzen mit IPv6-Adressen erstellen. Compute-Instanzen mit IPv4- und IPv6-Konfigurationen werden als Dual-Stack-Instanzen bezeichnet. Die IPv6-Adresse gilt zusätzlich zu den IPv4-Adressen, die auf der Netzwerkschnittstelle konfiguriert sind.

Sie können IPv6-Adressen auf einer Compute Engine-Instanz konfigurieren, wenn für das Subnetz, mit dem die Instanz verbunden ist, ein IPv6-Bereich konfiguriert ist.

Für jede Netzwerkschnittstelle auf der Compute-Instanz können IPv6-Adressen konfiguriert werden. Weitere Informationen zum Konfigurieren mehrerer Netzwerkschnittstellen finden Sie unter Mehrere Netzwerkschnittstellen.

Der Stack-Typ der Netzwerkschnittstelle einer Instanz bestimmt den Typ der Subnetze, mit denen eine Verbindung hergestellt werden kann:

  • Nur-IPv4-Netzwerkschnittstellen können eine Verbindung zu Dual-Stack- und reinen IPv4-Subnetzen herstellen.
  • Dual-Stack-Netzwerkschnittstellen können eine Verbindung zu Dual-Stack-Subnetzen herstellen.
  • Nur IPv6-Netzwerkschnittstellen können eine Verbindung zu Dual-Stack- und reinen IPv6-Subnetzen herstellen (Vorabversion).

Außerdem bestimmt die IPv6-Zugriffstypkonfiguration eines Subnetzes, ob das Subnetz einen internen oder externen IPv6-Bereich hat. Verbundene Instanzen übernehmen den IPv6-Zugriffstyp aus dem Subnetz.

Weitere Informationen zu IPv6-Adressen finden Sie unter IPv6 – Übersicht.

Beschränkungen

  • Reine IPv6-Instanzen (Vorabversion) werden nur mit Ubuntu und Debian unterstützt.

Hinweise

  • Sie müssen das Netzwerk und die Subnetze erstellen, bevor Sie die Compute-Instanz erstellen.
  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

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

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

    1. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.
    3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command:

        gcloud init

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

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Instanz mit IPv6-Adressen benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) für das Projekt zu gewähren. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen:

  • compute.instances.create für das Projekt
  • Zur Erstellung der VM mit einem benutzerdefinierten Image: compute.images.useReadOnly für das Image
  • Zur Erstellung der VM mithilfe eines Snapshots: compute.snapshots.useReadOnly für den Snapshot
  • So verwenden Sie eine Instanzvorlage zum Erstellen der VM: compute.instanceTemplates.useReadOnly für die Instanzvorlage
  • So weisen Sie der VM ein Legacy-Netzwerk zu: compute.networks.use für das Projekt
  • Zum Festlegen einer statische IP-Adresse für die VM: compute.addresses.use für das Projekt
  • So weisen Sie der VM eine externe IP-Adresse zu, wenn Sie ein Legacy-Netzwerk verwenden: compute.networks.useExternalIp für das Projekt
  • So geben Sie ein Subnetz für die VM an: compute.subnetworks.use für das Projekt oder für das ausgewählte Subnetz
  • So weisen Sie der VM eine externe IP-Adresse zu, wenn Sie ein VPC-Netzwerk verwenden: compute.subnetworks.useExternalIp für das Projekt oder für das ausgewählte Subnetz
  • Um Metadaten der VM-Instanz für die VM festzulegen: compute.instances.setMetadata für das Projekt
  • Um Tags für die VM festzulegen: compute.instances.setTags für die VM
  • Um Labels für die VM festzulegen: compute.instances.setLabels für die VM
  • Um ein Dienstkonto festzulegen, das die VM verwenden soll: compute.instances.setServiceAccount für die VM
  • Um ein neues Laufwerk für die VM zu erstellen: compute.disks.create für das Projekt
  • Um ein vorhandenes Laufwerk im Lese- oder Lese‑/Schreibmodus anzuhängen: compute.disks.use für das Laufwerk
  • Um ein vorhandenes Laufwerk im Lesemodus anzuhängen: compute.disks.useReadOnly für das Laufwerk

Dual-Stack-Instanz erstellen

Wenn Sie eine Instanz mit einer internen IPv4-Adresse und einer externen IPv6-Adresse erstellen möchten, verbinden Sie die Compute-Instanz mit einem Dual-Stack-Subnetz.

Wenn Sie eine freigegebene VPC verwenden und eine Dual-Stack-Instanz erstellen möchten, die mit einem freigegebenen Subnetz verbunden ist, finden Sie weitere Informationen unter Instanz erstellen in der Dokumentation zur freigegebenen VPC.

  1. Gehen Sie zur Seite Instanz erstellen.

    Zur Seite „Instanz erstellen“

  2. Wenn Sie dazu aufgefordert werden, wählen Sie Ihr Projekt aus und klicken auf Weiter. Die Seite Instanz erstellen wird angezeigt. Darin ist der Bereich Maschinenkonfiguration zu sehen.

  3. Führen Sie im Bereich Maschinenkonfiguration die folgenden Schritte aus:

    1. Geben Sie im Feld Name einen Namen für die Instanz ein. Weitere Informationen finden Sie unter Ressourcen benennen.
    2. Optional: Wählen Sie im Feld Zone eine Zone für diese Instanz aus. Wählen Sie eine Zone in einer Region aus, die ein Subnetz mit einem konfigurierten IPv6-Bereich enthält.
    3. Wählen Sie die Maschinenfamilie für Ihre Instanz aus. In der Google Cloud Console werden dann die Maschinenreihen angezeigt, die für die ausgewählte Maschinenfamilie verfügbar sind. Folgende Optionen für die Maschinenfamilie sind verfügbar:

      • Allgemein
      • Computing-optimiert
      • Speicheroptimiert
      • Speicheroptimiert
      • GPUs

    4. Wählen Sie in der Spalte Reihe die Maschinenreihe für Ihre Instanz aus.

    5. Wählen Sie im Abschnitt Maschinentyp den Maschinentyp für Ihre Instanz aus.

  4. Klicken Sie im Navigationsmenü auf Netzwerk. Führen Sie im angezeigten Bereich Netzwerk die folgenden Schritte aus:

    1. Klicken Sie im Bereich Netzwerkschnittstellen auf die Netzwerkschnittstelle, um sie zu maximieren und zu bearbeiten.

    2. Wählen Sie unter Netzwerk und Subnetzwerk das Netzwerk und Subnetzwerk aus, für das ein IPv6-Bereich konfiguriert ist.

    3. Wählen Sie für IP-Stack-Typ IPv4 und IPv6 (Dual-Stack) aus.

    4. Wählen Sie für Primäre interne IPv4-Adresse eine der folgenden Optionen aus:

      • Wählen Sie Sitzungsspezifisch aus, um eine neue sitzungsspezifische IPv4-interne Adresse zuzuweisen.
      • Wenn Sie eine vorhandene statische externe IP-Adresse zuweisen möchten, wählen Sie den Namen einer reservierten IPv4-Adresse aus der Liste aus.
      • Wenn Sie eine neue statische interne IPv4-Adresse erstellen und zuweisen möchten, wählen Sie Statische interne IPv4-Adresse reservieren aus.
    5. Optional: Wählen Sie für Externe IPv4-Adresse eine der folgenden Optionen aus:

      • Wenn Sie eine sitzungsspezifische externe IPv4-Adresse zuweisen möchten, wählen Sie Sitzungsspezifisch aus.
      • Wenn Sie eine Instanz ohne externe IPv4-Adresse erstellen möchten, wählen Sie None (Keine) aus.
      • Wenn Sie eine vorhandene statische externe IP-Adresse zuweisen möchten, wählen Sie den Namen einer reservierten IPv4-Adresse aus der Liste aus.
      • Wenn Sie eine neue statische externe IPv4-Adresse erstellen und zuweisen möchten, wählen Sie Statische externe IPv4-Adresse reservieren aus.
    6. Optional: Wenn Sie eine externe IPv6-Adresse konfigurieren möchten, wählen Sie unter Externe IPv6-Adresse eine der folgenden Optionen aus:

      • Wenn Sie eine neue sitzungsspezifische externe IPv6-Adresse zuweisen möchten, wählen Sie Automatisch zuweisen aus.
      • Wenn Sie eine vorhandene statische externe IP-Adresse zuweisen möchten, wählen Sie in der Liste den Namen einer reservierten IPv6-Adresse aus.
      • Wenn Sie eine neue statische externe IPv6-Adresse erstellen und zuweisen möchten, wählen Sie Statische externe IPv6-Adresse reservieren aus.
    7. Klicken Sie auf Fertig, um die Änderung der Netzwerkschnittstelle abzuschließen.

    8. Optional: Wenn Sie eine zusätzliche Netzwerkschnittstelle konfigurieren möchten, klicken Sie auf Netzwerkschnittstelle hinzufügen und wiederholen Sie die vorherigen Schritte für den Bereich Netzwerk.

  5. Optional: Geben Sie weitere Konfigurationsoptionen an. Weitere Informationen finden Sie unter Konfigurationsoptionen beim Erstellen einer Instanz.

  6. Klicken Sie zum Erstellen und Starten der Instanz auf Erstellen.

Erstellen Sie mithilfe des Befehls gcloud compute instances create eine Instanz.

gcloud compute instances create INSTANCE_NAME \
    --subnet=SUBNET_NAME \
    --zone=ZONE \
    --stack-type=IPV4_IPV6

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz
  • SUBNET_NAME: das Subnetz, mit dem die Instanz verbunden werden soll. Das Subnetz muss einen IPv6-Subnetzbereich haben.
  • ZONE: die Zone, in der die Instanz bereitgestellt werden soll
  1. Wählen Sie ein Imageaus. Notieren Sie sich den Namen des Images oder der Image-Familie und den Namen des Projekts, das das Image enthält.
  2. Erstellen Sie mit der Methode instances.insert eine Instanz aus einer Image-Familie oder einer bestimmten Version eines Betriebssystem-Images:

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • PROJECT_ID: ID des Projekts, in dem die Instanz erstellt werden soll.
    • ZONE: Zone, in der die Instanz erstellt wird.
    • MACHINE_TYPE_ZONE: Wenn Sie einen benutzerdefinierten Maschinentyp verwenden, geben Sie die Zone an, die den benutzerdefinierten Maschinentyp enthält, der für die neue Instanz verwendet werden soll. Andernfalls geben Sie die Zone an, in der die Instanz erstellt werden soll.
    • MACHINE_TYPE: Vordefinierter oder benutzerdefinierter Maschinentyp für die neue Instanz, z. B. n4-standard-2
    • INSTANCE_NAME: Name der neuen Instanz
    • REGION: die Region, die das Subnetz enthält
    • SUBNET: ein Dual-Stack-Subnetz
    • IMAGE_PROJECT (optional): das Image-Projekt, das das Image enthält
    • IMAGE: Optional: Geben Sie eine der folgenden Optionen an:

      • Eine bestimmte Version des Betriebssystem-Images, z. B. debian-12-bookworm-v20241009.
      • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Dadurch wird die Instanz aus dem neuesten nicht verworfenen Betriebssystem-Image erstellt. Wenn Sie beispielsweise family/debian-12 angeben, legt Compute Engine eine Instanz aus der neuesten Version des Betriebssystem-Images in der Debian 12-Image-Familie an. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

    HTTP-Methode und URL:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

    JSON-Text anfordern:

    {
        "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
        "name": "INSTANCE_NAME",
        "networkInterfaces": [
          {
            "subnetwork": "regions/REGION/subnetworks/SUBNET",
            "stackType": "IPV4_IPV6"
          }
        ],
        "disks": [
          {
            "initializeParams": {
              "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
            },
            "boot": true
          }
        ],
    }
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances"

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances" | Select-Object -Expand Content

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

    {
      "kind": "compute#operation",
      "id": "9216044482154695709",
      "name": "operation-1739207409646-62dccc7d7bc58-d1350b42-64fdb7f7",
      "zone": "https://www.googleapis.com/compute/{api_version}/projects/`PROJECT_ID`/zones/`ZONE`",
      "operationType": "insert",
      "targetLink": "https://www.googleapis.com/compute/{api_version}/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`",
      "targetId": "2679381553616227357",
      "status": "RUNNING",
      "user": "USER_ID",
      "progress": 0,
      "insertTime": "2025-02-10T09:10:10.551-08:00",
      "startTime": "2025-02-10T09:10:10.551-08:00",
      "selfLink": "https://www.googleapis.com/compute/{api_version}/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
     "kind": "compute#operation"
    }
    

Nur-IPv6-Instanz erstellen

Folgen Sie der Anleitung in diesem Abschnitt, um eine reine IPv6-Instanz zu erstellen.

Eine Compute Engine-Instanz mit einer einzelnen Netzwerkschnittstelle kann je nach Zugriffstyp des Netzwerks, mit dem die Schnittstelle verbunden ist, eine interne oder externe IPv6-Adresse haben. Sie müssen ein benutzerdefiniertes Virtual Private Cloud (VPC)-Netzwerk mit einem Subnetz mit einem IPv6-Adressbereich erstellen.

Bevor Sie eine VM-Instanz mit mehreren NICs erstellen können, die sowohl interne als auch externe IPv6-Adressen verwendet, müssen Sie Folgendes erstellen:

  • Internes Netzwerk und Subnetz: Ein VPC-Netzwerk im benutzerdefinierten Modus mit aktivierter IPv6-ULA, ein Subnetz mit einem IPv6-Adressbereich und der Zugriffstyp auf internal festgelegt.
  • Externes Netzwerk und Subnetz: Ein zweites VPC-Netzwerk im benutzerdefinierten Modus, ein zweites Subnetz mit einem IPv6-Adressbereich und der Zugriffstyp external.

Wenn Sie die Instanz erstellen, konfigurieren Sie zwei Netzwerkschnittstellen: eine für die Verbindung zum Subnetz mit dem internen IPv6-Adressbereich und eine für die Verbindung zum Subnetz mit dem externen Adressbereich.

Wenn Sie eine freigegebene VPC verwenden und eine reine IPv6-Instanz erstellen möchten, die mit einem freigegebenen Subnetz verbunden ist, finden Sie weitere Informationen unter Instanz erstellen in der Dokumentation zur freigegebenen VPC.

  1. Gehen Sie zur Seite Instanz erstellen.

    Zur Seite „Instanz erstellen“

  2. Wenn Sie dazu aufgefordert werden, wählen Sie Ihr Projekt aus und klicken auf Weiter. Die Seite Instanz erstellen wird angezeigt. Darin ist der Bereich Maschinenkonfiguration zu sehen.

  3. Führen Sie im Bereich Maschinenkonfiguration die folgenden Schritte aus:

    1. Geben Sie im Feld Name einen Namen für die Instanz ein. Weitere Informationen finden Sie unter Ressourcen benennen.
    2. Optional: Wählen Sie im Feld Zone eine Zone für diese Instanz aus. Wählen Sie eine Zone in einer Region aus, die ein Subnetz mit einem konfigurierten IPv6-Bereich enthält.
    3. Wählen Sie die Maschinenfamilie für Ihre Instanz aus. In der Google Cloud Console werden dann die Maschinenreihen angezeigt, die für die ausgewählte Maschinenfamilie verfügbar sind. Folgende Maschinenfamilien sind verfügbar:

      • Allgemein
      • Computing-optimiert
      • Speicheroptimiert
      • Speicheroptimiert
      • GPUs

    4. Wählen Sie in der Spalte Reihe die Maschinenreihe für Ihre Instanz aus.

    5. Wählen Sie im Abschnitt Maschinentyp den Maschinentyp für Ihre Instanz aus.

  4. Klicken Sie im Navigationsmenü auf Netzwerk. Führen Sie im angezeigten Bereich Netzwerk die folgenden Schritte aus:

    1. Klicken Sie im Bereich Netzwerkschnittstellen auf die Netzwerkschnittstelle, um sie zu maximieren und zu bearbeiten.

    2. Wählen Sie unter Netzwerk und Subnetzwerk das Netzwerk und Subnetzwerk aus, für das ein IPv6-Bereich konfiguriert ist.

      Der IPv6-Zugriffstyp des Subnetzes bestimmt, ob die Instanz eine interne IPv6-Adresse oder eine externe IPv6-Adresse erhält. Wenn Sie eine interne IPv6-Adresse zuweisen möchten, müssen Sie ein Netzwerk auswählen, das mit der Option Internen ULA-IPv6-Bereich für dieses VPC-Netzwerk konfigurieren erstellt wurde. Andernfalls können Sie nur externe IPv6-Adressen konfigurieren.

    3. Wählen Sie für IP-Stack-Typ die Option IPv6 (einzelner Stack) aus.

    4. Wenn Sie ein Subnetz mit dem Zugriffstyp Internal ausgewählt haben, wählen Sie für Primäre interne IPv6-Adresse eine der folgenden Optionen aus:

      • Wenn Sie eine neue sitzungsspezifische IPv6-Adresse zuweisen möchten, wählen Sie Automatisch zugewiesen (/96) aus.
      • Wenn Sie eine vorhandene statische interne IP-Adresse zuweisen möchten, wählen Sie den Namen einer reservierten IPv6-Adresse aus der Liste aus.
      • Wählen Sie Statische interne IPv6-Adresse reservieren aus, um eine neue statische interne IPv6-Adresse zu erstellen und zuzuweisen.
    5. Wenn Sie ein Subnetz mit dem Zugriffstyp External ausgewählt haben, wählen Sie für Externe IPv6-Adresse eine der folgenden Optionen aus:

      • Wenn Sie eine neue sitzungsspezifische externe IPv6-Adresse zuweisen möchten, wählen Sie Automatisch zuweisen aus.
      • Wenn Sie eine vorhandene statische externe IP-Adresse zuweisen möchten, wählen Sie in der Liste den Namen einer reservierten IPv6-Adresse aus.
      • Wenn Sie eine neue statische externe IPv6-Adresse erstellen und zuweisen möchten, wählen Sie Statische externe IPv6-Adresse reservieren aus.
    6. Klicken Sie auf Fertig, um die Änderung der Netzwerkschnittstelle abzuschließen.

    7. Optional: So fügen Sie eine zusätzliche IPv6-Adresse hinzu:

      1. Wählen Sie Netzwerkschnittstelle hinzufügen aus.
      2. Wiederholen Sie die vorherigen Schritte in dieser Aufgabe für den Bereich Netzwerk.
  5. Optional: Geben Sie weitere Konfigurationsoptionen an. Weitere Informationen finden Sie unter Konfigurationsoptionen beim Erstellen einer Instanz.

  6. Klicken Sie zum Erstellen und Starten der Instanz auf Erstellen.

Erstellen Sie mithilfe des Befehls gcloud beta compute instances create eine Instanz. Wenn Sie sowohl interne als auch externe IPv6-Adressen zuweisen möchten, müssen Sie die Instanz mit mindestens zwei Netzwerkschnittstellen erstellen.

gcloud beta compute instances create INSTANCE_NAME \
    --zone ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes,image='projects/IMAGE_PROJECT/global/images/IMAGE',size=SIZE \
    --network-interface=subnet=SUBNET_INTERNAL_NAME,stack-type=IPV6_ONLY \
    --network-interface=subnet=SUBNET_EXTERNAL_NAME,stack-type=IPV6_ONLY,ipv6-network-tier=PREMIUM

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: ein Name für die Instanz
  • ZONE: Die Zone, in der die Instanz erstellt wird, z. B. europe-west1-b. Die Region der Instanz wird aus der Zone abgeleitet.
  • MACHINE_TYPE: Optional: Vordefinierter oder benutzerdefinierter Maschinentyp für die neue Instanz. Beispiel: n4-standard-2
  • IMAGE_PROJECT (optional): das Image-Projekt, das das Image enthält
  • IMAGE: Optional: Wählen Sie eine der folgenden Optionen aus:
    • Eine bestimmte Version des Betriebssystem-Images; Beispiel: debian-12-bookworm-v202410095.
    • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Dadurch wird die Instanz aus dem neuesten nicht verworfenen Betriebssystem-Image erstellt. Wenn Sie beispielsweise family/debian-12 angeben, legt Compute Engine eine Instanz aus der neuesten Version des Betriebssystem-Images in der Debian 12-Image-Familie an. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.
  • SIZE: Optional: ist die Größe des neuen Laufwerks. Der Wert muss eine ganze Zahl sein. Die Standardeinheit ist GiB.
  • SUBNET_INTERNAL_NAME: Name des Subnetzes, das für interne IP-Adressen konfiguriert ist, die mit der Instanz verwendet werden sollen.
  • SUBNET_EXTERNAL_NAME: Name des Subnetzes, das für externe IP-Adressen konfiguriert ist, die mit der Instanz verwendet werden sollen.
  1. Wählen Sie ein Imageaus. Notieren Sie sich den Namen des Images oder der Image-Familie und den Namen des Projekts, das das Image enthält.
  2. Erstellen Sie mit der Methode instances.insert eine Instanz aus einer Image-Familie oder einer bestimmten Version eines Betriebssystem-Images:

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • PROJECT_ID: ID des Projekts, in dem die Instanz erstellt werden soll.
    • ZONE: Zone, in der die Instanz erstellt wird.
    • MACHINE_TYPE_ZONE: Wenn Sie einen benutzerdefinierten Maschinentyp verwenden, geben Sie die Zone an, die den benutzerdefinierten Maschinentyp enthält, der für die neue Instanz verwendet werden soll. Andernfalls geben Sie die Zone an, in der die Instanz erstellt werden soll.
    • MACHINE_TYPE: Maschinentyp, vordefiniert oder benutzerdefiniert, für die neue Instanz, z. B. n4-standard-2.
    • INSTANCE_NAME: Name der neuen Instanz
    • REGION: die Region, die das Subnetz enthält
    • SUBNET_INTERNAL: ein reines IPv6-Subnetz. Das Netzwerk für dieses Subnetz muss den Zugriffstyp INTERNAL haben und IPv6 ULA muss aktiviert sein.
    • SUBNET_EXTERNAL: ein reines IPv6-Subnetz. Das Netzwerk für dieses Subnetz muss den Zugriffstyp INTERNAL haben.
    • IMAGE_PROJECT (optional): das Image-Projekt, das das Image enthält
    • IMAGE: Optional: Geben Sie eine der folgenden Optionen an:

      • Eine bestimmte Version des Betriebssystem-Images, z. B. debian-12-bookworm-v20241009.
      • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Dadurch wird die Instanz aus dem neuesten nicht verworfenen Betriebssystem-Image erstellt. Wenn Sie beispielsweise family/debian-12 angeben, legt Compute Engine eine Instanz aus der neuesten Version des Betriebssystem-Images in der Debian 12-Image-Familie an. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

    HTTP-Methode und URL:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances

    JSON-Text anfordern:

    {
        "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
        "name": "INSTANCE_NAME",
        "networkInterfaces": [
          {
            "subnetwork": "regions/REGION/subnetworks/SUBNET_INTERNAL",
            "stackType": "IPV6_ONLY"
          },
          {
            "subnetwork": "regions/REGION/subnetworks/SUBNET_EXTERNAL",
            "stackType": "IPV6_ONLY"
          }
        ],
        "disks": [
          {
            "initializeParams": {
              "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
    
            },
            "boot": true
          }
        ]
    }
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances"

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances" | Select-Object -Expand Content

    Sie sollten in etwa folgende JSON-Antwort erhalten:

    {
      "kind": "compute#operation",
      "id": "9216044482154695709",
      "name": "operation-1739207409646-62dccc7d7bc58-d1350b42-64fdb7f7",
      "zone": "https://www.googleapis.com/compute/beta/projects/`PROJECT_ID`/zones/`ZONE`",
      "operationType": "insert",
      "targetLink": "https://www.googleapis.com/compute/beta/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`",
      "targetId": "2679381553616227357",
      "status": "RUNNING",
      "user": "USER_ID",
      "progress": 0,
      "insertTime": "2025-02-10T09:10:10.551-08:00",
      "startTime": "2025-02-10T09:10:10.551-08:00",
      "selfLink": "https://www.googleapis.com/compute/beta/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
     "kind": "compute#operation"
    }
    

Nächste Schritte