User`s guide

Operations on Virtual Machines and Containers 73

Listing Snapshots

To list all snapshots of a particular virtual machine, use the pctl snapshot-list

command:

# pctl snapshot-list MyVM

PARENT_SNAPSHOT_ID SNAPSHOT_ID

{989f3415-3e30-4494-936e-a0bbc104bd20}

{989f3415-3e30-4494-936e-a0bbc104bd20} *{063615fa-f2a0-4c14-92d4-4c935df15840}

This command shows that currently two snapshots exist for the MyVM virtual machine. The

snapshot with ID {063615fa-f2a0-4c14-92d4-4c935df15840} is based on the

snapshot with ID {989f3415-3e30-4494-936e-a0bbc104bd20}, i.e. the latter acts as

the parent for the snapshot with ID {063615fa-f2a0-4c14-92d4-4c935df15840}.

The * sign before {063615fa-f2a0-4c14-92d4-4c935df15840} denotes that this is

the current snapshot for the given virtual machine.

You can also view the relationship between snapshots by specifying the -t option:

# pctl snapshot-list MyVM -t

_{989f3415-3e30-4494-936e-a0bbc104bd20}_{063615fa-f2a0-4c14-92d4-4c935df15840}

\*{712305b0-3742-4ecc-9ef1-9f1e345d0ab8}

The command output shows you that currently 2 branches exist for the MyVM virtual machine.

The snapshot with ID {989f3415-3e30-4494-936e-a0bbc104bd20} is the baseline

used as a starting point for these branches.

You can get detailed information on a particular snapshot using the -i option and specifying the

snapshot ID:

# pctl snapshot-list MyVM -i {063615fa-f2a0-4c14-92d4-4c935df15840}

ID: {063615fa-f2a0-4c14-92d4-4c935df15840}

Name: Clean_System

Date: 2009-07-22 22:39:06

Current: yes

State: power_off

Description: <![CDATA[This snapshot was created right after installing Windows

XP operating system]]>

The pctl snapshot-list command displays the following information about snapshots:

Field Description

The ID assigned to the snapshot.

Name

The name assigned to the snapshot.

Date

The date and time when the snapshot was created.

Current

Denotes whether this is the current snapshot of the virtual

machine.

State

The state the virtual machine was in at the time you took the

snapshot.

Description

The description set for the snapshot.