KI-optimierte Instanz mit A4X erstellen

In diesem Dokument wird beschrieben, wie Sie eigenständige VM-Instanzen erstellen, die A4X-Maschinentypen verwenden. Weitere Informationen zu diesem Maschinentyp finden Sie unter A4X.

Weitere Informationen zum Erstellen von VMs oder Clustern finden Sie unter Übersicht über Bereitstellungsoptionen.

Beschränkungen

Beim Erstellen einer eigenständigen A4X-VM gelten die folgenden Einschränkungen:

Achtung: Das Service Level Agreement (SLA) für Compute Engine gilt nicht für die Maschinenserien A4X Max und A4X.

• Sie erhalten weder Rabatte für kontinuierliche Nutzung noch flexible Rabatte für zugesicherte Nutzung für Instanzen, die diese Maschinentypen verwenden. Außerdem unterstützen A4X Max-Maschinentypen keine ressourcenbasierten Rabatte für zugesicherte Nutzung.
• Sie können Instanzen nur in bestimmten Regionen und Zonen erstellen.
• Sie können keinen nichtflüchtigen Speicher (regional oder zonenbasiert) verwenden. Sie können nur Google Cloud Hyperdisk verwenden.
• Diese Maschinentypen sind nur auf der NVIDIA Grace-Plattform verfügbar.
• Änderungen des Maschinentyps werden für A4X Max oder A4X nicht unterstützt. Wenn Sie zu einem dieser Maschinentypen wechseln oder von einem dieser Maschinentypen wechseln möchten, müssen Sie eine neue A4X-Max- oder A4X-Instanz erstellen.
• Sie können Windows-Betriebssysteme nicht auf diesen Maschinentypen ausführen.
• Bei A4X-Instanzen werden die Zähler für physische Ports, die mit _phy enden, nicht aktualisiert, wenn Sie ethtool -S verwenden, um das GPU-Netzwerk zu überwachen. Das ist das erwartete Verhalten für Instanzen, die die MRDMA-Architektur mit virtuellen Funktionen (VF) verwenden. Weitere Informationen finden Sie unter MRDMA-Funktionen und Tools zur Netzwerküberwachung.
• A4X Max- und A4X-Instanzen unterstützen Folgendes nicht:
  • Einzelne Mandanten
  • Spot-VMs
  • Flex-Start-VMs
• Sie können Hyperdisk ML-Laufwerke, die vor dem 4. Februar 2026 erstellt wurden, nicht an A4X-Maschinentypen anhängen.

Hinweise

Führen Sie vor dem Erstellen von VMs die folgenden Schritte aus, falls Sie dies noch nicht getan haben:

1. Nutzungsoption auswählen: Die von Ihnen gewählte Nutzungsoption bestimmt, wie Sie GPU-Ressourcen beziehen und nutzen.

   Weitere Informationen finden Sie unter Nutzungsoption auswählen.

2. Kapazität abrufen: Der Prozess zum Abrufen von Kapazität unterscheidet sich für jede Verbrauchsoption.

   Informationen zum Erhalten von Kapazität für die von Ihnen gewählte Verbrauchsoption finden Sie unter Kapazitätsübersicht.

   Hinweis:Wenn Sie A4X-Kapazität anfordern, erhalten Sie sie im Modus „Alle Kapazitäten“. Dieser Modus ist der einzige unterstützte Betriebsmodus für Reservierungen für A4X-Maschinentypen. Weitere Informationen zum Modus „Alle Kapazitäten“ finden Sie unter Betriebsmodus für Reservierungen.

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

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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.

Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command:

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Erforderliche Rollen

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

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen von VMs erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die genau erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Folgende Berechtigungen sind zum Erstellen von VMs erforderlich:

• compute.instances.create für das Projekt
• Zum Erstellen der VM mit einem benutzerdefinierten Image: compute.images.useReadOnly für das Image
• Zum Erstellen der VM mit einem Snapshot: compute.snapshots.useReadOnly für den Snapshot
• Zum Erstellen der VM mit einer Instanzvorlage: compute.instanceTemplates.useReadOnly für die Instanzvorlage
• Zum Angeben eines Subnetzes für Ihre VM: compute.subnetworks.use für das Projekt oder für das ausgewählte Subnetz
• Zum Festlegen einer statischen IP-Adresse für die VM: compute.addresses.use für das Projekt
• Zum Zuweisen einer externen IP-Adresse zur VM, wenn Sie ein VPC-Netzwerk verwenden: compute.subnetworks.useExternalIp für das Projekt oder für das ausgewählte Subnetz
• Zum Zuweisen eines Legacy-Netzwerks zur VM: compute.networks.use für das Projekt
• Zum Zuweisen einer externen IP-Adresse zur VM, wenn Sie ein Legacy-Netzwerk verwenden: compute.networks.useExternalIp für das Projekt
• Zum Festlegen von Metadaten der VM-Instanz für die VM: compute.instances.setMetadata für das Projekt
• Zum Festlegen von Tags für die VM: compute.instances.setTags für die VM
• Zum Festlegen von Labels für die VM: compute.instances.setLabels für die VM
• Zum Festlegen eines Dienstkontos für die VM: compute.instances.setServiceAccount für die VM
• Zum Erstellen eines neuen Laufwerks für die VM: compute.disks.create für das Projekt
• Zum Anhängen eines vorhandenen Laufwerks im Lese- oder Lese-/Schreibmodus: compute.disks.use für das Laufwerk
• Zum Anhängen eines vorhandenen Laufwerks im Lesemodus: compute.disks.useReadOnly für das Laufwerk

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

A4X-Grundlagen

Ein A4X-Cluster ist in eine Hierarchie von Blöcken und Unterblöcken unterteilt, um eine nicht blockierende Netzwerkleistung im großen Maßstab zu ermöglichen. Das Verständnis dieser Topologie ist entscheidend, wenn Sie Kapazität reservieren und Arbeitslasten bereitstellen.

A4X-Instanz

Eine A4X-Instanz ist ein einzelner A4X-Maschinentyp mit 4 angehängten GPUs.

NVLink-Domain oder ‑Unterblock

Eine NVLink-Domain, auch als Subblock bezeichnet, ist die Grundeinheit der A4X-Kapazität. Eine NVLink-Domäne besteht aus 18 A4X-Instanzen (72 GPUs), die über ein Multi-Node-NVLink-System verbunden sind. Sie erstellen eine A4X-NVLink-Domain oder einen Unterblock, indem Sie eine Richtlinie für kompakte Platzierung anwenden, die eine 1x72-Topologie angibt.

Blockieren

Ein A4X-Block besteht aus 25 Unterblöcken (NVLink-Domains) mit insgesamt bis zu 450 A4X-Instanzen (1.800 GPUs). Die Unterblöcke sind schienenorientiert, um eine effiziente Skalierung zu ermöglichen. Für jeden Unterblock ist eine kompakte Platzierungsrichtlinie erforderlich. Für einen einzelnen A4X-Block können Sie daher 25 Richtlinien für kompakte Platzierung erstellen.

Die folgende Tabelle zeigt die unterstützten Topologieoptionen für A4X-Instanzen:

Topologie (gpuTopology)	Anzahl der GPUs	Anzahl der Instanzen
1x72	72	18

Übersicht

Tipp:Wenn Sie eine NVLink-Domain mit der 1x72-Topologie verwenden möchten, können Sie die Befehle zum Erstellen einzelner Instanzen 18 Mal ausführen oder die Methode instances.bulkInsert verwenden, mit der mehrere Instanzen mit einer einzigen API-Anfrage erstellt werden können. Informationen zum Erstellen von A4X-Instanzen im Bulk finden Sie unter A4X-Instanzen im Bulk erstellen.

Das Erstellen einer Instanz mit dem Maschinentyp A4X umfasst die folgenden Schritte:

1. VPC-Netzwerke erstellen
2. Richtlinie für kompakte Platzierung erstellen
3. Instanz erstellen

VPC-Netzwerke erstellen

Tipp:Wenn Sie einen Schnelltest einrichten, können Sie diesen Schritt überspringen und stattdessen eine einzelne NIC --network-interface=nic-type=GVNIC angeben.

Wenn Sie das Netzwerk für den Maschinentyp A4X einrichten möchten, erstellen Sie drei VPC-Netzwerke für die folgenden Netzwerkschnittstellen:

• 2 reguläre VPC-Netzwerke für die gVNIC-Netzwerkschnittstellen (NIC). Sie werden für die Kommunikation zwischen Hosts verwendet.
• Für die CX-7-NICs ist ein VPC-Netzwerk mit dem RoCE-Netzwerkprofil erforderlich, wenn mehrere A4X-Subblöcke erstellt werden. Das RoCE-VPC-Netzwerk muss vier Subnetze haben, ein Subnetz für jede CX-7-NIC. Diese NICs verwenden RDMA over Converged Ethernet (RoCE) und bieten so die Kommunikation mit hoher Bandbreite und geringer Latenz, die für die Skalierung auf mehrere A4X-Unterblöcke erforderlich ist. Bei einem einzelnen A4X-Subblock können Sie dieses VPC-Netzwerk überspringen, da die direkte GPU-zu-GPU-Kommunikation innerhalb eines einzelnen Subblocks über das Multi-Node-NVLink erfolgt.

Weitere Informationen zur NIC-Anordnung finden Sie unter Netzwerkbandbreite und NIC-Anordnung prüfen.

Sie können die Netzwerke entweder manuell anhand der Anleitungen oder automatisch mit dem bereitgestellten Skript erstellen.

Anleitungen

So erstellen Sie die Netzwerke:

• Informationen zum Erstellen der regulären VPC-Netzwerke für die gVNICs finden Sie unter VPC-Netzwerke erstellen und verwalten.
• Informationen zum Erstellen des RoCE-VPC-Netzwerks finden Sie unter VPC-Netzwerk für RDMA-NICs erstellen.

Für diese VPC-Netzwerke empfehlen wir, die maximale Übertragungseinheit (Maximum Transmission Unit, MTU) auf einen höheren Wert festzulegen. Für den Maschinentyp A4X wird eine MTU von 8896 Bytes empfohlen. Die empfohlenen MTU-Einstellungen für andere GPU-Maschinentypen finden Sie unter MTU-Einstellungen für GPU-Maschinentypen.

Skript

So erstellen Sie die Netzwerke:

Für diese VPC-Netzwerke empfehlen wir, die maximale Übertragungseinheit (Maximum Transmission Unit, MTU) auf einen höheren Wert festzulegen. Für den Maschinentyp A4X wird eine MTU von 8896 Bytes empfohlen. Die empfohlenen MTU-Einstellungen für andere GPU-Maschinentypen finden Sie unter MTU-Einstellungen für GPU-Maschinentypen.

1. Verwenden Sie das folgende Skript, um reguläre VPC-Netzwerke für die gVNICs zu erstellen.

     
       #!/bin/bash
   
       # Create regular VPC networks and subnets for the gVNICs
       for N in $(seq 0 1); do
         gcloud compute networks create GVNIC_NAME_PREFIX-net-$N \
           --subnet-mode=custom \
           --mtu=8896
   
         gcloud compute networks subnets create GVNIC_NAME_PREFIX-sub-$N \
           --network=GVNIC_NAME_PREFIX-net-$N \
           --region=REGION \
           --range=192.168.$N.0/24
   
         gcloud compute firewall-rules create GVNIC_NAME_PREFIX-internal-$N \
           --network=GVNIC_NAME_PREFIX-net-$N \
           --action=ALLOW \
           --rules=tcp:0-65535,udp:0-65535,icmp \
           --source-ranges=192.168.0.0/16
       done
   
       # Create SSH firewall rules
       gcloud compute firewall-rules create GVNIC_NAME_PREFIX-ssh \
         --network=GVNIC_NAME_PREFIX-net-0 \
         --action=ALLOW \
         --rules=tcp:22 \
         --source-ranges=IP_RANGE
   
       # Assumes that an external IP is only created for vNIC 0
       gcloud compute firewall-rules create GVNIC_NAME_PREFIX-allow-ping-net-0 \
         --network=GVNIC_NAME_PREFIX-net-0 \
         --action=ALLOW \
         --rules=icmp \
         --source-ranges=IP_RANGE
   
     

2. Wenn Sie mehrere A4X-Subblöcke benötigen, verwenden Sie das folgende Skript, um das RoCE-VPC-Netzwerk und die Subnetze für die vier CX-7-NICs auf jeder A4X-Instanz zu erstellen.

   Wichtig:Wenn Ihre Bereitstellung nur aus einem einzelnen A4X-Unterblock besteht, können Sie diesen Schritt überspringen.

     
       # List and make sure network profiles exist in the machine type's zone
       gcloud compute network-profiles list --filter "location.name=ZONE"
   
       # Create network for CX-7
       gcloud compute networks create RDMA_NAME_PREFIX-mrdma \
         --network-profile=ZONE-vpc-roce \
         --subnet-mode custom \
         --mtu=8896
   
       # Create subnets
       for N in $(seq 0 3); do
         gcloud compute networks subnets create RDMA_NAME_PREFIX-mrdma-sub-$N \
           --network=RDMA_NAME_PREFIX-mrdma \
           --region=REGION \
           --range=192.168.$((N+2)).0/24 & # offset to avoid overlap with gVNICs
       done
   
     

   Ersetzen Sie Folgendes:

   • GVNIC_NAME_PREFIX: Das benutzerdefinierte Namenspräfix, das für die regulären VPC-Netzwerke und -Subnetze für die gVNICs verwendet werden soll.
   • RDMA_NAME_PREFIX: Das benutzerdefinierte Namenspräfix, das für das RoCE-VPC-Netzwerk und die Subnetze für die CX-7-NICs verwendet werden soll.
   • ZONE: Geben Sie eine Zone an, in der der Maschinentyp, den Sie verwenden möchten, verfügbar ist, z. B. us-central1-a. Informationen zu Regionen finden Sie unter GPU-Verfügbarkeit nach Regionen und Zonen.
   • REGION: Die Region, in der Sie die Subnetze erstellen möchten. Diese Region muss der angegebenen Zone entsprechen. Wenn Ihre Zone beispielsweise us-central1-a ist, lautet Ihre Region us-central1.
   • IP_RANGE: Der IP-Bereich, der für die SSH-Firewallregeln verwendet werden soll.
3. Optional: Prüfen Sie die Netzwerkeinstellungen in der Google Cloud -Konsole, um zu bestätigen, dass die VPC-Netzwerkressourcen erfolgreich erstellt wurden:
   1. Rufen Sie in der Google Cloud Console die Seite VPC-Netzwerke auf.

      Zur Seite VPC-Netzwerke

   2. Suchen Sie in der Liste nach den Netzwerken, die Sie im vorherigen Schritt erstellt haben.
   3. Klicken Sie auf den Namen des Netzwerks, um die Subnetze, Firewallregeln und andere Netzwerkeinstellungen aufzurufen.

Kompakte Platzierungsrichtlinie erstellen

Wichtig:Wenn Sie mehrere NVLink-Domains in einem Block erstellen möchten, empfehlen wir, für jede NVLink-Domain eine separate kompakte Platzierungsrichtlinie zu erstellen. Wenn Sie eine Richtlinie für kompakte Platzierung wiederverwenden, versucht Compute Engine, die Instanzen im selben Subblock zu platzieren, der bereits verwendet wird.

Wählen Sie eine der folgenden Optionen aus, um eine Richtlinie für kompakte Platzierung zu erstellen:

gcloud

Verwenden Sie zum Erstellen einer Richtlinie für kompakte Platzierung den Befehl gcloud beta compute resource-policies create group-placement:

gcloud beta compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --gpu-topology=1x72 \
    --region=REGION

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der Richtlinie für kompakte Platzierung.
• REGION: Die Region, in der Sie die Richtlinie für kompakte Platzierungen erstellen möchten. Geben Sie eine Region an, in der der gewünschte Maschinentyp verfügbar ist. Informationen zu Regionen finden Sie unter GPU-Verfügbarkeit nach Regionen und Zonen.

REST

Senden Sie zum Erstellen einer Richtlinie für kompakte Platzierung eine POST-Anfrage an die Beta-Methode resourcePolicies.insert.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies
  {
    "name": "POLICY_NAME",
    "groupPlacementPolicy": {
      "collocation": "COLLOCATED",
      "gpuTopology": "1x72"
    }
  }

Ersetzen Sie Folgendes:

• PROJECT_ID: Ihre Projekt-ID.
• POLICY_NAME: der Name der Richtlinie für kompakte Platzierung.
• REGION: Die Region, in der Sie die Richtlinie für kompakte Platzierungen erstellen möchten. Geben Sie eine Region an, in der der gewünschte Maschinentyp verfügbar ist. Informationen zu Regionen finden Sie unter GPU-Verfügbarkeit nach Regionen und Zonen.

A4X-Instanz erstellen

Um eine GPU-Topologie von 1x72 zu erhalten, erstellen Sie 18 Instanzen. Wenden Sie beim Erstellen der Instanzen die Richtlinie für kompakte Platzierung an, in der das Feld gpuTopology angegeben ist. Durch Anwenden der Richtlinie wird sichergestellt, dass Compute Engine alle 18 Instanzen in einem Unterblock erstellt, um eine NVLink-Domain zu verwenden.

Wenn einem untergeordneten Block die Kapazität für eine Instanz fehlt, schlägt die Anfrage zum Erstellen der Instanz fehl.

Wichtig:Wenn Sie eine A4X-Instanz mit einer 1x72-Topologie erstellen, weist Compute Engine der bei der Erstellung verwendeten Platzierungsrichtlinie einen gesamten Unterblock mit 18 Instanzen (NVLink-Domain) zu. Wenn Sie weniger als 18 Instanzen erstellen, bleiben die nicht verwendeten Instanzen in diesem Unterblock inaktiv und sind für andere Anfragen, die eine andere Richtlinie für die Platzierung verwenden, nicht verfügbar. Es ist jedoch möglich, diese ungenutzten Instanzen mit derselben Richtlinie bereitzustellen. Um die Ressourceneffizienz zu maximieren, empfehlen wir, genau 18 Instanzen zu erstellen.

Wählen Sie eine der folgenden Optionen aus, um eine A4X-Instanz zu erstellen.

Mit den folgenden Befehlen wird auch der Zugriffsbereich für Ihre Instanzen festgelegt. Um die Berechtigungsverwaltung zu vereinfachen, empfiehlt Google, den Zugriffsbereich für eine Instanz auf cloud-platform-Zugriff festzulegen und dann mit IAM-Rollen zu definieren, auf welche Dienste die Instanz zugreifen kann. Weitere Informationen finden Sie unter Best Practices für Bereiche.

gcloud

Verwenden Sie zum Erstellen der VM den Befehl gcloud compute instances create.

Wichtig:Im folgenden Beispiel wird die Netzwerkeinrichtung für mehrere Unterblöcke verwendet. Wenn Sie nur einen einzelnen A4X-Unterblock erstellen und das gVNIC-Netzwerk nur im Schritt VPC-Netzwerke erstellen erstellt haben, entfernen Sie die vier RDMA-Subnetze, die im Beispiel durch den NIC-Typ MRDMA angegeben werden.

gcloud compute instances create VM_NAME  \
    --machine-type=a4x-highgpu-4g \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --zone=ZONE \
    --boot-disk-type=hyperdisk-balanced \
    --boot-disk-size=DISK_SIZE \
    --scopes=cloud-platform \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
    --network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address \
    --network-interface=nic-type=MRDMA,network=RDMA_NAME_PREFIX-mrdma,subnet=RDMA_NAME_PREFIX-mrdma-sub-0,no-address \
    --network-interface=nic-type=MRDMA,network=RDMA_NAME_PREFIX-mrdma,subnet=RDMA_NAME_PREFIX-mrdma-sub-1,no-address \
    --network-interface=nic-type=MRDMA,network=RDMA_NAME_PREFIX-mrdma,subnet=RDMA_NAME_PREFIX-mrdma-sub-2,no-address \
    --network-interface=nic-type=MRDMA,network=RDMA_NAME_PREFIX-mrdma,subnet=RDMA_NAME_PREFIX-mrdma-sub-3,no-address \
    --reservation-affinity=specific \
    --reservation=RESERVATION \
    --provisioning-model=RESERVATION_BOUND \
    --instance-termination-action=TERMINATION_ACTION \
    --maintenance-policy=TERMINATE \
    --restart-on-failure \
    --resource-policies=POLICY_NAME

Ersetzen Sie Folgendes:

• VM_NAME: der Name der VM.
• IMAGE_FAMILY: die Image-Familie des Betriebssystem-Images, das Sie verwenden möchten. Eine Liste der unterstützten Betriebssysteme finden Sie unter Details zu Betriebssystemen.
• IMAGE_PROJECT: die Projekt-ID des Betriebssystem-Images.
• ZONE: die Zone, in der der Maschinentyp verfügbar ist, den Sie verwenden möchten. Sie müssen eine Zone in derselben Region wie die Richtlinie für kompakte Platzierung verwenden. Informationen zu Regionen finden Sie unter GPU-Verfügbarkeit nach Regionen und Zonen.
• DISK_SIZE: Die Größe des Bootlaufwerks in GB.
• GVNIC_NAME_PREFIX: Das Namenspräfix, das Sie beim Erstellen der standardmäßigen VPC-Netzwerke und -Subnetze angegeben haben, die gVNICs verwenden.
• RDMA_NAME_PREFIX: Das Namenspräfix, das Sie beim Erstellen der VPC-Netzwerke und ‑Subnetze angegeben haben, die RDMA-NICs verwenden.
• RESERVATION: Der Name der Reservierung, eines Blocks oder eines Unterblocks innerhalb einer Reservierung. Informationen zum Abrufen des Reservierungsnamens oder der verfügbaren Blöcke finden Sie unter Reservierte Kapazität ansehen. Wählen Sie je nach Ihren Anforderungen an die Platzierung von Instanzen eine der folgenden Optionen aus:
  • So erstellen Sie die Instanzen in einem beliebigen Block:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
        

  • So erstellen Sie die Instanzen auf einem bestimmten Block:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
        

  • So erstellen Sie die Instanzen in einem bestimmten Unterblock:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME/reservationSubBlocks/RESERVATION_SUBBLOCK_NAME
        

  Tipp:Wenn die Reservierung im aktuellen Projekt vorhanden ist, können Sie projects/RESERVATION_OWNER_PROJECT_ID/reservations/ aus dem Reservierungswert weglassen.

• TERMINATION_ACTION: Gibt an, ob Compute Engine die VM am Ende des Reservierungszeitraums beendet (STOP) oder löscht (DELETE).

• POLICY_NAME: der Name der Richtlinie für kompakte Platzierung.

REST

Senden Sie zum Erstellen der VM eine POST-Anfrage an die Methode instances.insert.

Wichtig:Im folgenden Beispiel wird die Netzwerkeinrichtung für mehrere Unterblöcke verwendet. Wenn Sie nur einen einzelnen A4X-Unterblock erstellen und das gVNIC-Netzwerk nur im Schritt VPC-Netzwerke erstellen erstellt haben, entfernen Sie die vier RDMA-Subnetze, die im Beispiel durch den NIC-Typ MRDMA angegeben werden.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/a4x-highgpu-4g",
  "name": "VM_NAME",
  "disks":[
    {
      "boot":true,
      "initializeParams":{
        "diskSizeGb": "DISK_SIZE",
        "diskType": "hyperdisk-balanced",
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "mode": "READ_WRITE",
      "type": "PERSISTENT"
    }
  ],
  "serviceAccounts": [
    {
      "email": "default",
      "scopes": [
        "https://www.googleapis.com/auth/cloud-platform"
      ]
    }
  ],
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "name": "external-nat",
          "type": "ONE_TO_ONE_NAT"
        }
      ],
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
    },
    {
      "network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
      "nicType": "GVNIC",
      "subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
    }
  ],
  "reservationAffinity":{
    "consumeReservationType": "SPECIFIC_RESERVATION",
    "key": "compute.googleapis.com/reservation-name",
    "values":[
      "RESERVATION"
    ]
  },
  "scheduling":{
    "provisioningModel": "RESERVATION_BOUND",
    "instanceTerminationAction": "TERMINATION_ACTION",
    "onHostMaintenance": "TERMINATE",
    "automaticRestart": true
  },
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

Ersetzen Sie Folgendes:

• PROJECT_ID: die Projekt-ID des Projekts, in dem Sie die VM erstellen möchten.
• ZONE: die Zone, in der der Maschinentyp verfügbar ist, den Sie verwenden möchten. Sie müssen eine Zone in derselben Region wie die Richtlinie für kompakte Platzierung verwenden. Informationen zu Regionen finden Sie unter GPU-Verfügbarkeit nach Regionen und Zonen.
• VM_NAME: der Name der VM.
• DISK_SIZE: Die Größe des Bootlaufwerks in GB.
• IMAGE_PROJECT: die Projekt-ID des Betriebssystem-Images.
• IMAGE_FAMILY: die Image-Familie des Betriebssystem-Images, das Sie verwenden möchten. Eine Liste der unterstützten Betriebssysteme finden Sie unter Details zu Betriebssystemen.
• NETWORK_PROJECT_ID: die Projekt-ID des Netzwerks.
• GVNIC_NAME_PREFIX: Das Namenspräfix, das Sie beim Erstellen der standardmäßigen VPC-Netzwerke und -Subnetze angegeben haben, die gVNICs verwenden.
• REGION: die Region des Subnetzwerks.
• RDMA_NAME_PREFIX: Das Namenspräfix, das Sie beim Erstellen der VPC-Netzwerke und ‑Subnetze angegeben haben, die RDMA-NICs verwenden.
• RESERVATION: Der Name der Reservierung, eines Blocks oder eines Unterblocks innerhalb einer Reservierung. Informationen zum Abrufen des Reservierungsnamens oder der verfügbaren Blöcke finden Sie unter Reservierte Kapazität ansehen. Wählen Sie je nach Ihren Anforderungen an die Platzierung von Instanzen eine der folgenden Optionen aus:
  • So erstellen Sie die Instanzen in einem beliebigen Block:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
        

  • So erstellen Sie die Instanzen auf einem bestimmten Block:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
        

  • So erstellen Sie die Instanzen in einem bestimmten Unterblock:

        projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME/reservationSubBlocks/RESERVATION_SUBBLOCK_NAME
        

  Tipp:Wenn die Reservierung im aktuellen Projekt vorhanden ist, können Sie projects/RESERVATION_OWNER_PROJECT_ID/reservations/ aus dem Reservierungswert weglassen.

• TERMINATION_ACTION: Gibt an, ob Compute Engine die VM am Ende des Reservierungszeitraums beendet (STOP) oder löscht (DELETE).

• PROJECT_ID: die Projekt-ID der Richtlinie für kompakte Platzierung.
• REGION: die Region der Richtlinie für kompakte Platzierung.
• POLICY_NAME: der Name der Richtlinie für kompakte Platzierung.

Nächste Schritte

• Topologie einer Compute-Instanz ansehen
• Arbeitslasten ausführen – Übersicht
• Fehlerbehebung bei der Nutzung von Reservierungen

Feedback geben