Snapshot XML format
Snapshot XML
Attributes of libvirt snapshots are stored as child elements of
the domainsnapshot
element. At snapshot creation
time, only the name
and description
elements are settable; the rest of the fields are informational
(and readonly) and will be filled in by libvirt when the
snapshot is created.
The top-level domainsnapshot
element may contain
the following elements:
name
- The name for this snapshot. If the name is specified when initially creating the snapshot, then the snapshot will have that particular name. If the name is omitted when initially creating the snapshot, then libvirt will make up a name for the snapshot.
description
- A human-readable description of the snapshot. If the description is omitted when initially creating the snapshot, then this field will be empty.
creationTime
- The time this snapshot was created. The time is specified in seconds since the Epoch, UTC (i.e. Unix time). Readonly.
state
- The state of the domain at the time this snapshot was taken. When the domain is reverted to this snapshot, the domain's state will be set to whatever is in this field. Readonly.
parent
- The parent of this snapshot. This element contains exactly one child element, name. This specifies the name of the parent snapshot of this snapshot, and is used to represent trees of snapshots. Readonly.
domain
- The domain that this snapshot was taken against. This element contains exactly one child element, uuid. This specifies the uuid of the domain that this snapshot was taken against. Readonly.
Example
<domainsnapshot> <name>os-updates</name> <description>Snapshot of OS install and updates</description> <state>running</state> <creationTime>1270477159</creationTime> <parent> <name>bare-os-install</name> </parent> <domain> <uuid>93a5c045-6457-2c09-e56c-927cdf34e178</uuid> </domain> </domainsnapshot>