Snapshot

The Snapshot data source can be used to search for and return an existing snapshot which can then be used to provision a server. If a single match is found, it will be returned. If your search results in multiple matches, an error will be returned. When this happens, please refine your search string so that it is specific enough to return only one result.

Example Usage

By ID

By Name & Size & Location

Note: The size argument is in GB

Argument Reference

• id - (Optional) UUID of an existing snapshot that you want to search for.

• name - (Optional) Name of an existing snapshot that you want to search for.

• location - (Optional) Existing snapshot's location.

• size - (Optional) The size of the snapshot to look for.

Either name or id must be provided. If none, or both are provided, the datasource will return an error. Additionally, you can add location and size along with the name argument for a more refined search. If a single match is found, it will be returned. If your search results in multiple matches, an error will be returned. When this happens, please refine your search string so that it is specific enough to return only one result.

Attributes Reference

The following attributes are returned by the datasource:

• id - UUID of the snapshot

• name - The name of the snapshot.

• description - Human readable description

• licence_type - OS type of this Snapshot

• location - Location of that image/snapshot

• size - The size of the image in GB

• sec_auth_protection - Boolean value representing if the snapshot requires extra protection e.g. two factor protection

• cpu_hot_plug - Is capable of CPU hot plug (no reboot required)

• cpu_hot_unplug - Is capable of CPU hot unplug (no reboot required)

• ram_hot_plug - Is capable of memory hot plug (no reboot required)

• ram_hot_unplug - Is capable of memory hot unplug (no reboot required)

• nic_hot_plug - Is capable of nic hot plug (no reboot required)

• nic_hot_unplug - Is capable of nic hot unplug (no reboot required)

• disc_virtio_hot_plug - Is capable of Virt-IO drive hot plug (no reboot required)

• disc_virtio_hot_unplug - Is capable of Virt-IO drive hot unplug (no reboot required). This works only for non-Windows virtual Machines.

• disc_scsi_hot_plug - Is capable of SCSI drive hot plug (no reboot required)

• disc_scsi_hot_unplug - Is capable of SCSI drive hot unplug (no reboot required). This works only for non-Windows virtual Machines.