Dell EMC Restore
CertifiedEnterprise EditionRestore a Dell EMC PowerStore volume from a snapshot
Dell EMC Restore
Restore a Dell EMC PowerStore volume from a snapshot
Restores the parent volume in place to the state captured by the snapshot, via
POST /api/rest/volume/{volumeId}/restore with body {"from_snap_id": "<snapshotId>"}. This is
destructive: any data written to the volume after the snapshot was taken is lost. The snapshot
itself is left untouched. PowerStore may accept the request asynchronously (HTTP 202 with a job
reference); see wait and waitTimeout.
type: io.kestra.plugin.ee.dellemc.powerstore.snapshots.RestoreExamples
Restore a volume from a snapshot.
id: powerstore_restore_snapshot
namespace: company.team
tasks:
- id: restore_snapshot
type: io.kestra.plugin.ee.dellemc.powerstore.snapshots.Restore
host: "{{ secret('POWERSTORE_HOST') }}"
username: "{{ secret('POWERSTORE_USERNAME') }}"
password: "{{ secret('POWERSTORE_PASSWORD') }}"
volumeId: "{{ inputs.volume_id }}"
snapshotId: "{{ inputs.snapshot_id }}"
Properties
host *Requiredstring
PowerStore management address
Hostname or IP address of the PowerStore appliance management interface, optionally including a
port if non-default (for example: powerstore.example.com or 192.168.1.20: 8443).
The REST API is reached at https://{host}/api/rest.
password *Requiredstring
PowerStore password
Password for username. Store this value as a Kestra secret and reference it via
{{ secret('POWERSTORE_PASSWORD') }}.
snapshotId *Requiredstring
Snapshot ID
ID of the PowerStore snapshot to restore the volume from.
username *Requiredstring
PowerStore username
Username of a PowerStore local or LDAP account used to authenticate via HTTP Basic Auth.
volumeId *Requiredstring
Volume ID
ID of the PowerStore volume to restore — the parent volume the snapshot was taken from.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
skipTlsVerification booleanstring
falseSkip TLS certificate verification
When true, accepts the PowerStore appliance's TLS certificate without validation. Defaults to
false. PowerStore management interfaces are commonly deployed with a self-signed certificate;
set this to true to connect to those without importing the certificate into a trust store.
Intended for lab/non-production use — leave false in production and use a properly signed
certificate instead.
wait booleanstring
trueWait for completion
When the PowerStore array accepts the request asynchronously (HTTP 202 with a job reference),
whether to poll the job until it completes before returning. Defaults to true so downstream
tasks receive a usable result. When false, the task returns immediately with the job ID once
accepted, without waiting for it to finish. Polling blocks the worker thread running this task
for as long as the wait lasts (up to waitTimeout); size the worker pool accordingly if many
job-aware tasks run concurrently, or set this to false and poll separately.
waitTimeout string
PT10MJob wait timeout
Maximum time to wait for an asynchronously accepted job to complete when wait is true.
Defaults to PT10M. Capped at PT30M: values above that are clamped down to PT30M (with a
warning logged) to avoid tying up a worker thread indefinitely. If the timeout elapses before
the job completes, the task returns successfully without confirmed completion — the job ID is
still available in the output so its status can be checked later. Killing the execution while
this task is waiting stops it from polling immediately, but PowerStore's job REST resource has
no cancel/abort endpoint: the array-side operation itself (resize, failover, synchronize,
restore) keeps running to completion on the appliance regardless.
Outputs
jobId string
Job ID
ID of the asynchronous PowerStore job, populated only when the restore is still in progress (see wait).
