Troubleshooting licenses Stay organized with collections Save and categorize content based on your preferences.
This document shows you how to resolve issues related to importing and migratingvirtual machine (VM) instances to Compute Engine that have a misappliedlicense.
For example, learn how to resolve issues with a VM that has an on-demand licenseinstead of a bring your own license (BYOL). For information about the differenttypes of licenses, seeAbout licenses.
Mitigate incorrect license imports or migrations
If you tried to import or migrate a VM into Compute Engine with a BYOL or BYOSlicense, but the VM'slicense stringis not appended withbyol orbyos, then your license was not successfullyimported or migrated with the VM.
To resolve this issue, do one of the following depending on how you imported ormigrated the VM:
If you imported the VM using the
gcloud compute instances importcommandor the Cloud Build API, import the VM again, and specify the--osflag with thebyolversion of the OS.If you imported the VM using the
gcloud beta compute machine-images importcommand,import the VM again, and specify the--byolflag.If you imported the VM using the
gcloud beta compute images importcommand,import the VM again, and specify the--byolflag.If you migrated the VM using Migrate to Virtual Machines, contactCloud Customer Care to help you resolve the issue. For more information, seeGetting support with Cloud Customer Care.
What's next
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.