Das folgende Problem tritt auf, wenn das zum Erstellen der VM verwendete Image nicht für die Verwendung von gVNIC getaggt ist.
ERROR: (gcloud.compute.instances.create) Could not fetch resource:
- Invalid value for field 'resource.networkInterfaces[0].nicType': 'GVNIC'.
NetworkInterface NicType can only be set to GVNIC on instances with
GVNIC GuestOsFeature.
Um dieses Problem zu beheben, sollten Sie ein Image verwenden, das mit gVNIC getaggt ist.
Weitere Informationen finden Sie unter Benutzerdefiniertes Image erstellen.
Sonstige Probleme
In diesem Abschnitt finden Sie weitere Fehler, die bei der Verwendung des gVNIC-Treibers mit Ihrer Compute Engine-Instanz auftreten können.
Die VM-Instanz konnte nicht gebootet werden
Ursache: gVNIC ist auf dem Image nicht aktiviert.
Diagnose: Prüfen Sie, ob gVNIC für das Image aktiviert ist.
Überprüfen Sie das Ergebnis mit folgendem Befehl:
gcloud compute images describe IMAGE_NAME
Ersetzen Sie IMAGE_NAME durch den Namen des Images.
Die Ausgabe des Befehls sollte unter guestOsFeaturesGVNIC enthalten.
Sie können auch prüfen, ob bei der Erstellung der VM nic-type auf gVNIC gesetzt war. Führen Sie hierzu den folgenden Befehl aus:
Stellen Sie über SAC die Verbindung zur Instanz her.
Melden Sie sich mit Ihrem Nutzernamen und Ihrem Passwort an.
Führen Sie in der Eingabeaufforderung den folgenden Befehl aus:
dism /online /get-drivers | findstr gvnic
Sehen Sie sich das Ergebnis an.
Wenn der Treiber installiert ist, sollte der Text Original File Name : gvnic.inf ausgegeben werden.
Wenn der Treiber nicht installiert ist, wird keine Nachricht zurückgegeben.
Lösung: Ist gVNIC nicht verfügbar, achten Sie darauf, dass Sie einunterstütztes Image verwenden und ob Sie gVNIC auf Ihrem benutzerdefinierten Image richtig eingerichtet haben.
In der VPC festgelegter MTU-Wert wird von der Compute-Instanz nicht verwendet
Nachdem Sie der Anleitung zum Ändern des MTU-Werts gefolgt sind, wird in der MTU-Konfiguration der Instanz nicht derselbe MTU-Wert verwendet. Sie können beispielsweise den Befehl /sbin/ifconfig | grep mtu auf Ihrer Instanz ausführen, um die MTU-Einstellung zu prüfen. Sie haben die Instanz neu gestartet, aber die Instanzkonfiguration wurde nicht aktualisiert.
Ursache:Die gVNIC-Treiberversion ist zu alt.
Lösung:
Wenn für Ihre Instanz ein öffentliches Image verwendet wird, sehen Sie sich auf der Seite Details zu Betriebssystemen auf dem Tab Netzwerkfeatures die Informationen zu Ihrer Betriebssystemversion an. Achten Sie darauf, dass Jumbo-Frames vollständig unterstützt werden.
Wenn das öffentliche Image Jumbo Frames nicht vollständig unterstützt oder Sie ein benutzerdefiniertes Betriebssystem-Image verwenden, ist die installierte Version des gVNIC-Treibers zu alt und unterstützt die höheren MTU-Werte nicht. Folgen Sie der Anleitung im Abschnitt Nicht unterstützte Betriebssysteme verwenden, um den gVNIC-Treiber für Ihre Compute-Instanz zu aktualisieren.
Nachdem Sie den gVNIC-Treiber aktualisiert haben, starten Sie die Instanz neu und prüfen Sie die MTU-Konfiguration noch einmal.
Schlechter Netzwerkdurchsatz für Windows Server 2022- und Windows 11-VMs
Bei Verwendung von Google Virtual NIC (gVNIC) mit Windows Server 2022- und Windows 11-VMs, die die GooGet-Paketversion 1.0.0@44 von gVNIC-Treibern oder eine frühere Version verwenden, kann es zu einem schlechten Netzwerkdurchsatz kommen.
Aktualisieren Sie das gVNIC-Treiber-GooGet-Paket auf Version 1.0.0@45 oder höher, um dieses Problem zu beheben:
Prüfen Sie, welche Treiberversion auf Ihrer VM installiert ist. Führen Sie dazu den folgenden Befehl über eine Administrator-Eingabeaufforderung oder eine PowerShell-Sitzung aus:
Wenn die Treiberversion google-compute-engine-driver-gvnic.x86_641.0.0@44 oder früher ist, aktualisieren Sie das GooGet-Paket-Repository. Führen Sie dazu den folgenden Befehl über eine Administrator-Eingabeaufforderung oder PowerShell-Sitzung:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-03 (UTC)."],[[["\u003cp\u003eTo resolve errors related to gVNIC, ensure the VM image is tagged to use gVNIC and verify this by using the \u003ccode\u003egcloud compute images describe IMAGE_NAME\u003c/code\u003e command and checking for \u003ccode\u003eGVNIC\u003c/code\u003e under \u003ccode\u003eguestOsFeatures\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf a VM instance doesn't boot, confirm that gVNIC is enabled on the image and that the \u003ccode\u003enic-type\u003c/code\u003e is set to \u003ccode\u003egVNIC\u003c/code\u003e during VM creation, which can be verified using the \u003ccode\u003egcloud compute instances describe VM_NAME\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eIf a VM instance boots but is not reachable over the network, check if the gVNIC driver is installed and loaded using \u003ccode\u003emodinfo gve\u003c/code\u003e and \u003ccode\u003elsmod | grep gve\u003c/code\u003e for Linux, or \u003ccode\u003edism /online /get-drivers | findstr gvnic\u003c/code\u003e for Windows.\u003c/p\u003e\n"],["\u003cp\u003eIf the MTU value set in VPC isn't used by the compute instance, update the gVNIC driver to the latest version by checking the OS support for Jumbo Frames and, if necessary, manually updating the driver using the provided instructions, then restart the instance.\u003c/p\u003e\n"],["\u003cp\u003eFor Windows Server 2022 and Windows 11 VMs experiencing poor networking throughput with gVNIC, update the gVNIC driver GooGet package to version \u003ccode\u003e1.0.0@45\u003c/code\u003e or later by using the \u003ccode\u003egooget installed\u003c/code\u003e and update commands.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting Google Virtual NIC\n\n*** ** * ** ***\n\nHere are some tips to help troubleshoot [Google Virtual NIC (gVNIC)](/compute/docs/networking/using-gvnic).\n\nCommon errors\n-------------\n\nThe following issue occurs when the image used to create the VM\nis not tagged to use gVNIC. \n\n```\nERROR: (gcloud.compute.instances.create) Could not fetch resource:\n - Invalid value for field 'resource.networkInterfaces[0].nicType': 'GVNIC'.\nNetworkInterface NicType can only be set to GVNIC on instances with\nGVNIC GuestOsFeature.\n```\n\nTo resolve this issue, ensure that you are using an image that is tagged to use gVNIC.\nFor more information, see [Create a custom image](/compute/docs/networking/using-gvnic#create-custom-image).\n\nOther issues\n------------\n\nThis section contains other errors that you might encounter when using the\ngVNIC driver with your Compute Engine instance.\n\n### VM instance didn't boot\n\n- **Cause:** gVNIC is not enabled on the image.\n\n- **Diagnosis:** Check that the image has `gVNIC` enabled.\n To verify, run the following command:\n\n ```\n gcloud compute images describe IMAGE_NAME\n ```\n\n Replace \u003cvar translate=\"no\"\u003eIMAGE_NAME\u003c/var\u003e with the name of your image.\n\n The output of the command should show `GVNIC` under `guestOsFeatures`.\n\n You can also check if the VM was created with the `nic-type` set to\n `gVNIC`. To do this run the following command: \n\n ```\n gcloud compute instances describe VM_NAME\n ```\n\n Replace \u003cvar translate=\"no\"\u003eVM_NAME\u003c/var\u003e with the name of your VM.\n- **Resolution:** Ensure that you are using a\n [supported image](/compute/docs/networking/using-gvnic#os-support) or that you have properly\n [set up the gVNIC driver](/compute/docs/networking/using-gvnic#manual-gvnic-setup) on your custom image.\n\n### VM instance booted but is not reachable over the network\n\n- **Cause:** gVNIC was not successfully installed and loaded.\n\n- **Diagnosis:** To check if the driver was installed and loaded, complete the\n following steps:\n\n ### Linux\n\n 1. Check that the driver is installed.\n\n ```\n modinfo gve\n ```\n\n The output should resemble the following: \n\n ```\n filename: /lib/modules/4.15.0-1036-gcp/updates/dkms/gve.ko\n version: 1.1.0\n license: Dual MIT/GPL\n description: gVNIC Driver\n author: Google, XXX.\n srcversion: 5FEFB9DD945EB2DEC94EE09\n alias: pci:v00001AE0d00000042sv*sd*bc*sc*i*\n depends:\n retpoline: Y\n name: gve\n vermagic: 4.15.0-1036-gcp SMP mod_unload\n ```\n 2. Check that the driver is loaded.\n\n ```\n lsmod | grep gve\n ```\n\n The output should resemble the following: \n\n ```\n gve 49152 0\n ```\n\n ### Windows\n\n 1. Connect to instance through [SAC](/compute/docs/instances/connecting-to-windows#windows_cli).\n 2. Login with your username and password.\n 3. From the command prompt, run the following command:\n\n ```\n dism /online /get-drivers | findstr gvnic\n ```\n 4. Review the result.\n\n - If the driver is installed, you should see the text `Original File Name : gvnic.inf` in the output.\n - If the driver is not installed, no message is returned.\n | **Note:** You can also review the [interactive serial console](/compute/docs/instances/interacting-with-serial-console) when debugging issues with your connection.\n- **Resolution:** If gVNIC is not\n available, ensure that you are using a\n [supported image](/compute/docs/networking/using-gvnic#os-support) or that\n you have properly\n [set up gVNIC](/compute/docs/networking/using-gvnic#manual-gvnic-setup)\n on your custom image.\n\n### MTU value set in VPC not being used by compute instance\n\nAfter following the instructions to\n[change the MTU value](/vpc/docs/change-mtu-vpc-network), the MTU\nconfiguration on the instance isn't using the same MTU value. For example,\nyou might run the `/sbin/ifconfig | grep mtu` command on your instance to check\nthe MTU setting. You have restarted the instance, but the instance\nconfiguration isn't updated.\n\n**Cause:** The gVNIC driver version is too old\n\n**Resolution:**\n\n1. If your instance uses a public image, review the **Networking features** tab for your OS version on the [Operating system details](/compute/docs/images/os-details#network-features) page. Make sure it shows that Jumbo Frames are completely supported.\n2. If the public image doesn't fully support Jumbo Frames, or if you are using a custom OS image, then the installed version of the gVNIC driver is too old, and doesn't support the higher MTU values. Follow the instructions in the section \"[Use on non-supported operating systems](/compute/docs/networking/using-gvnic#manual-gvnic-setup)\" to update the gVNIC driver for your compute instance.\n3. After updating the gVNIC driver, restart the instance and recheck the MTU configuration.\n\n### Poor networking throughput for Windows Server 2022 and Windows 11 VMs\n\nYou might experience poor networking throughput when using\n[Google Virtual NIC (gVNIC)](/compute/docs/networking/using-gvnic) with\nWindows Server 2022 and Windows 11 VMs that use gVNIC driver GooGet package\nversion `1.0.0@44` or earlier.\n\nTo resolve this issue, update the gVNIC driver GooGet package to version\n`1.0.0@45` or later by doing the following:\n\n1. Check which driver version is installed on your VM by running the following\n command from an administrator Command Prompt or Powershell session:\n\n ```\n googet installed\n ```\n\n The output looks similar to the following: \n\n ```\n Installed packages:\n ...\n google-compute-engine-driver-gvnic.x86_64 VERSION_NUMBER\n ...\n ```\n2. If the `google-compute-engine-driver-gvnic.x86_64` driver version is\n `1.0.0@44` or earlier, update the update the\n [GooGet package repository](https://github.com/google/googet)\n by running the following command from an administrator Command Prompt or\n Powershell session:\n\n ```\n google-compute-engine-driver-gvnic.x86_64\n ```"]]
