# VZError.Code Errors you might encounter when configuring or using a virtual machine. ``` enum Code ``` ## Overview The domain for these errors is [`VZErrorDomain`](/documentation/Virtualization/VZErrorDomain). When an error originates in a different component, the object contains the domain of that component. ## Topics ### Error codes [`VZError.Code.internalError`](/documentation/Virtualization/VZError/Code/internalError) An internal error, such as the VM unexpectedly stopping. [`VZError.Code.invalidVirtualMachineConfiguration`](/documentation/Virtualization/VZError/Code/invalidVirtualMachineConfiguration) An invalid configuration error. [`VZError.Code.invalidVirtualMachineState`](/documentation/Virtualization/VZError/Code/invalidVirtualMachineState) An invalid state error. [`VZError.Code.invalidVirtualMachineStateTransition`](/documentation/Virtualization/VZError/Code/invalidVirtualMachineStateTransition) An invalid state transition error. [`VZError.Code.invalidDiskImage`](/documentation/Virtualization/VZError/Code/invalidDiskImage) An invalid disk-image error. [`VZError.Code.virtualMachineLimitExceeded`](/documentation/Virtualization/VZError/Code/virtualMachineLimitExceeded) Unable to create an additional VM. [`VZError.Code.networkError`](/documentation/Virtualization/VZError/Code/networkError) A network error, such as a failed connection error, occurred. [`VZError.Code.notSupported`](/documentation/Virtualization/VZError/Code/notSupported) The host computer or operating system isn’t supported. [`VZError.Code.outOfDiskSpace`](/documentation/Virtualization/VZError/Code/outOfDiskSpace) The host is out of disk space. [`VZError.Code.operationCancelled`](/documentation/Virtualization/VZError/Code/operationCancelled) The code that indicates user canceled the installation of Rosetta or the app canceled the installation of a guest OS. [`VZError.Code.installationFailed`](/documentation/Virtualization/VZError/Code/installationFailed) An error occurred during installation. [`VZError.Code.installationRequiresUpdate`](/documentation/Virtualization/VZError/Code/installationRequiresUpdate) The VM requires a software update in order to complete the installation. [`VZError.Code.invalidRestoreImage`](/documentation/Virtualization/VZError/Code/invalidRestoreImage) The restore image is invalid. [`VZError.Code.invalidRestoreImageCatalog`](/documentation/Virtualization/VZError/Code/invalidRestoreImageCatalog) The restore image catalog is invalid. [`VZError.Code.noSupportedRestoreImagesInCatalog`](/documentation/Virtualization/VZError/Code/noSupportedRestoreImagesInCatalog) The restore image catalog has no supported restore images. [`VZError.Code.restoreImageCatalogLoadFailed`](/documentation/Virtualization/VZError/Code/restoreImageCatalogLoadFailed) The restore image catalog failed to load. [`VZError.Code.restoreImageLoadFailed`](/documentation/Virtualization/VZError/Code/restoreImageLoadFailed) The restore image failed to load. [`VZError.Code.networkBlockDeviceNegotiationFailed`](/documentation/Virtualization/VZError/Code/networkBlockDeviceNegotiationFailed) The connection or the negotiation with the network block device server failed. [`VZError.Code.networkBlockDeviceDisconnected`](/documentation/Virtualization/VZError/Code/networkBlockDeviceDisconnected) The network block device client disconnected from the server. [`VZError.Code.restore`](/documentation/Virtualization/VZError/Code/restore) The VM failed to restore from save file. [`VZError.Code.save`](/documentation/Virtualization/VZError/Code/save) The VM failed to save to the save file. [`VZError.Code.deviceAlreadyAttached`](/documentation/Virtualization/VZError/Code/deviceAlreadyAttached) The device already has an attachment to the VM. [`VZError.Code.deviceInitializationFailure`](/documentation/Virtualization/VZError/Code/deviceInitializationFailure) A device initialization failure. [`VZError.Code.deviceNotFound`](/documentation/Virtualization/VZError/Code/deviceNotFound) The framework can’t find the device. [`VZError.Code.usbControllerNotFound`](/documentation/Virtualization/VZError/Code/usbControllerNotFound) The framework can’t find the controller. [`VZError.Code.internalError`](/documentation/Virtualization/VZError/Code/internalError) An internal error, such as the VM unexpectedly stopping. [`VZError.Code.invalidVirtualMachineConfiguration`](/documentation/Virtualization/VZError/Code/invalidVirtualMachineConfiguration) An invalid configuration error. [`VZError.Code.invalidVirtualMachineState`](/documentation/Virtualization/VZError/Code/invalidVirtualMachineState) An invalid state error. [`VZError.Code.invalidVirtualMachineStateTransition`](/documentation/Virtualization/VZError/Code/invalidVirtualMachineStateTransition) An invalid state transition error. [`VZError.Code.invalidDiskImage`](/documentation/Virtualization/VZError/Code/invalidDiskImage) An invalid disk-image error. [`VZError.Code.virtualMachineLimitExceeded`](/documentation/Virtualization/VZError/Code/virtualMachineLimitExceeded) Unable to create an additional VM. [`VZError.Code.networkError`](/documentation/Virtualization/VZError/Code/networkError) A network error, such as a failed connection error, occurred. [`VZError.Code.notSupported`](/documentation/Virtualization/VZError/Code/notSupported) The host computer or operating system isn’t supported. [`VZError.Code.outOfDiskSpace`](/documentation/Virtualization/VZError/Code/outOfDiskSpace) The host is out of disk space. [`VZError.Code.operationCancelled`](/documentation/Virtualization/VZError/Code/operationCancelled) The code that indicates user canceled the installation of Rosetta or the app canceled the installation of a guest OS. [`VZError.Code.installationFailed`](/documentation/Virtualization/VZError/Code/installationFailed) An error occurred during installation. [`VZError.Code.installationRequiresUpdate`](/documentation/Virtualization/VZError/Code/installationRequiresUpdate) The VM requires a software update in order to complete the installation. [`VZError.Code.invalidRestoreImage`](/documentation/Virtualization/VZError/Code/invalidRestoreImage) The restore image is invalid. [`VZError.Code.invalidRestoreImageCatalog`](/documentation/Virtualization/VZError/Code/invalidRestoreImageCatalog) The restore image catalog is invalid. [`VZError.Code.noSupportedRestoreImagesInCatalog`](/documentation/Virtualization/VZError/Code/noSupportedRestoreImagesInCatalog) The restore image catalog has no supported restore images. [`VZError.Code.restoreImageCatalogLoadFailed`](/documentation/Virtualization/VZError/Code/restoreImageCatalogLoadFailed) The restore image catalog failed to load. [`VZError.Code.restoreImageLoadFailed`](/documentation/Virtualization/VZError/Code/restoreImageLoadFailed) The restore image failed to load. [`VZError.Code.networkBlockDeviceNegotiationFailed`](/documentation/Virtualization/VZError/Code/networkBlockDeviceNegotiationFailed) The connection or the negotiation with the network block device server failed. [`VZError.Code.networkBlockDeviceDisconnected`](/documentation/Virtualization/VZError/Code/networkBlockDeviceDisconnected) The network block device client disconnected from the server. [`VZError.Code.restore`](/documentation/Virtualization/VZError/Code/restore) The VM failed to restore from save file. [`VZError.Code.save`](/documentation/Virtualization/VZError/Code/save) The VM failed to save to the save file. [`VZError.Code.deviceAlreadyAttached`](/documentation/Virtualization/VZError/Code/deviceAlreadyAttached) The device already has an attachment to the VM. [`VZError.Code.deviceInitializationFailure`](/documentation/Virtualization/VZError/Code/deviceInitializationFailure) A device initialization failure. [`VZError.Code.deviceNotFound`](/documentation/Virtualization/VZError/Code/deviceNotFound) The framework can’t find the device. [`VZError.Code.usbControllerNotFound`](/documentation/Virtualization/VZError/Code/usbControllerNotFound) The framework can’t find the controller. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)