Dell EMC List
CertifiedEnterprise EditionList Dell EMC PowerStore volume snapshots
Dell EMC List
List Dell EMC PowerStore volume snapshots
Retrieves all snapshots for a given PowerStore volume. PowerStore has no dedicated
/volume/{id}/snapshot sub-collection; snapshots are volumes with type=Snapshot, so this task
filters the /volume collection via
GET /api/rest/volume?type=eq.Snapshot&protection_data->>source_id=eq.{volumeId}.
Results are paginated using limit/offset; all pages are fetched automatically.
type: io.kestra.plugin.ee.dellemc.powerstore.snapshots.ListExamples
List all snapshots of a volume.
id: powerstore_list_snapshots
namespace: company.team
tasks:
- id: list_snapshots
type: io.kestra.plugin.ee.dellemc.powerstore.snapshots.List
host: "{{ secret('POWERSTORE_HOST') }}"
username: "{{ secret('POWERSTORE_USERNAME') }}"
password: "{{ secret('POWERSTORE_PASSWORD') }}"
volumeId: "{{ inputs.volume_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') }}.
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 whose snapshots to list.
fetchType string
STORESTOREFETCHFETCH_ONENONEThe way you want to fetch the results
STORE (default) streams every snapshot to a file in Kestra internal storage and outputs its uri.
FETCH returns all snapshots in the rows output. FETCH_ONE returns only the first snapshot in the row output.
NONE returns just the total count.
pageSize integerstring
100Page size
Maximum number of snapshots retrieved per API page (1-1000). Defaults to 100.
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.
Outputs
row
First fetched snapshot
The first snapshot record. Populated for FETCH_ONE.
io.kestra.plugin.ee.dellemc.powerstore.snapshots.List-SnapshotRecord
rows array
Fetched snapshots
List of all snapshot records. Populated for FETCH.
io.kestra.plugin.ee.dellemc.powerstore.snapshots.List-SnapshotRecord
total integer
Total number of snapshots
API-reported total across all pages. Populated for FETCH, FETCH_ONE, NONE, and STORE.
uri string
uriStored snapshots URI
Internal storage URI of the ION file containing all snapshot records. Populated for STORE.
