Class: OvirtSDK4::SnapshotsService
- Defined in:
- lib/ovirtsdk4/services.rb,
lib/ovirtsdk4/services.rb
Instance Method Summary collapse
-
#add(snapshot, opts = {}) ⇒ Snapshot
Creates a virtual machine snapshot.
-
#list(opts = {}) ⇒ Array<Snapshot>
Returns the list of snapshots of the storage domain or virtual machine.
-
#service(path) ⇒ Service
Locates the service corresponding to the given path.
-
#snapshot_service(id) ⇒ SnapshotService
Locates the
snapshot
service.
Methods inherited from Service
Instance Method Details
#add(snapshot, opts = {}) ⇒ Snapshot
Creates a virtual machine snapshot.
For example, to create a new snapshot for virtual machine 123
send a request like this:
POST /ovirt-engine/api/vms/123/snapshots
With a request body like this:
<snapshot>
<description>My snapshot</description>
</snapshot>
For including only a sub-set of disks in the snapshots, add disk_attachments
element to the
request body. Note that disks which are not specified in disk_attachments
element will not be a
part of the snapshot. If an empty disk_attachments
element is passed, the snapshot will include
only the virtual machine configuration. If no disk_attachments
element is passed, then all
the disks will be included in the snapshot.
For each disk, image_id
element can be specified for setting the new active image id.
This is used in order to restore a chain of images from backup. I.e. when restoring
a disk with snapshots, the relevant image_id
should be specified for each snapshot
(so the identifiers of the disk snapshots are identical to the backup).
<snapshot>
<description>My snapshot</description>
<disk_attachments>
<disk_attachment>
<disk id="123">
<image_id>456</image_id>
</disk>
</disk_attachment>
</disk_attachments>
</snapshot>
Important
|
When a snapshot is created the default value for the persist_memorystate attribute is
|
19972 19973 19974 |
# File 'lib/ovirtsdk4/services.rb', line 19972 def add(snapshot, opts = {}) internal_add(snapshot, Snapshot, ADD, opts) end |
#list(opts = {}) ⇒ Array<Snapshot>
Returns the list of snapshots of the storage domain or virtual machine.
The order of the returned list of snapshots isn’t guaranteed.
20018 20019 20020 |
# File 'lib/ovirtsdk4/services.rb', line 20018 def list(opts = {}) internal_get(LIST, opts) end |
#service(path) ⇒ Service
Locates the service corresponding to the given path.
20040 20041 20042 20043 20044 20045 20046 20047 20048 20049 |
# File 'lib/ovirtsdk4/services.rb', line 20040 def service(path) if path.nil? || path == '' return self end index = path.index('/') if index.nil? return snapshot_service(path) end return snapshot_service(path[0..(index - 1)]).service(path[(index +1)..-1]) end |
#snapshot_service(id) ⇒ SnapshotService
Locates the snapshot
service.
20029 20030 20031 |
# File 'lib/ovirtsdk4/services.rb', line 20029 def snapshot_service(id) SnapshotService.new(self, id) end |