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
|
20178 20179 20180 |
# File 'lib/ovirtsdk4/services.rb', line 20178 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.
20224 20225 20226 |
# File 'lib/ovirtsdk4/services.rb', line 20224 def list(opts = {}) internal_get(LIST, opts) end |
#service(path) ⇒ Service
Locates the service corresponding to the given path.
20246 20247 20248 20249 20250 20251 20252 20253 20254 20255 |
# File 'lib/ovirtsdk4/services.rb', line 20246 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.
20235 20236 20237 |
# File 'lib/ovirtsdk4/services.rb', line 20235 def snapshot_service(id) SnapshotService.new(self, id) end |