How does the platform identify entities

The platform identifies VMs with the UUID and the provider ID. The user can also search for VMs by their Name.

ID	Notes
UUID	Universally unique identifier, for example, f1ac92c6-9a5d-46da-85d8-177fc099e3f2 Abiquo generates the UUID and it is always the same for the VM, even if you undeploy or redeploy the VM. You should be able to use the UUID to find the VM in the Abiquo API
Provider ID	For deployed VMs
VM Name	By default the VM template Name or a user-friendly name entered by the user

When the platform creates a VM in the cloud provider, it assigns the VM Name to the VM. The platform then obtains the provider's ID for the VM.

Virtual machine provider IDs

The platform identifies deployed VMs using the provider ID.

The following table shows some example identifiers and naming rules.

Provider	Provider ID example	VM Name notes	Additional notes
Amazon	i-00ab90b5e33820836
Azure	/subscriptions/bd81406c-6028-4037-9f03-9a3af4ff725d/resourcegroups/azurergnardo53000westeurope/ providers/microsoft.compute/virtualmachines/ubuntuserver#5f9465c6-6a2b-4544-94c5-1e78f124db7d	Cannot be empty, and user cannot edit after deploy Windows <= 15 characters Others <= 64 characters	You cannot have more than one VM with the same Name in a resource group Azure resource names cannot contain special characters \/""[]:\|<>+=;,?*@& or begin with '_' or end with '.' or '-' The platform checks the names of VMs that are not allocated See https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/resource-name-rules#microsoftcompute
GCP	7029510428967378677
vCloud	urn:vcloud:vm:b4f82701-e0d1-488b-9ea3-ba078115a4e0	Name attribute
vCenter hosts and clusters	eb75c6bf-3059-47e2-a99b-72834909d3eb#vm-97641	If the platform receives a duplicate name exception it adds a number (N) to the name and retries

Virtual appliance names

By default, the platform onboards each VM into a separate VApp and it will name the VApp with the VM label. However, if you use the enterprise property to onboard to a single VApp, then this functionality will not be used. You can configure the name of the VApp with an appropriate enterprise property or edit it manually after you create the VApp.

Virtual datacenter names

The platform onboards and synchronizes virtual datacenter names as follows:

For Amazon, the platform uses the VPC Name attribute
For vCloud, the platform uses the Name of the vCloud vApp
For Azure, the platform uses the Name of the Virtual Network
For GCP, the platform uses the Name of the public cloud region

If the public cloud provider plugin does not have a name for the virtual datacenter, the platform uses the provider ID as the name.

Subnet names

A subnet (private network) has the name of the private network in Amazon, Azure, and GCP. The provider ID for Amazon is the subnet ID and for Azure it is "resource group + / + vdc + / private network name, for example "abiquo-centralindia/test/default_private_network".