---
title: "Get Volume Snapshot Propagation by Appliance"
method: POST
path: "/telemetry/volumes/{volume_id}/snapshot_propagation_by_appliance"
tags: ["Ops IQ"]
---

# Get Volume Snapshot Propagation by Appliance

`POST /telemetry/volumes/{volume_id}/snapshot_propagation_by_appliance`

## Request

- Base URL: `https://am1.portal.api.nasuni.com`
- URL: `https://am1.portal.api.nasuni.com/telemetry/volumes/{volume_id}/snapshot_propagation_by_appliance`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nasuni/apis/portal-api/docs/telemetry/volumes/:volume_id/snapshot_propagation_by_appliance/post.ts> (a function with typed inputs; its response is checked against the schema)

Get snapshot propagation telemetry by appliance for a volume.

## Path parameters

- `volume_id` string, required

## Request body

- VolumeTelemetryRequestDto: Request DTO for volume telemetry data (volume_id is in URL path).
  - `period` string, required: Time period in ISO 8601 format. Examples: 'PT1H' (last 1 hour), 'P1D' (last 1 day), '2025-01-01T00:00:00Z/2025-01-02T00:00:00Z' (specific interval), or millisecond timestamps '1730390400000/1730476800000'. Minimum range: 6 minutes.
  - `serial_numbers` string[], required: Appliance serial numbers to filter data - ensures stability across DR events
  - `chart_width` integer, nullable: Chart width in pixels (100-5200) - affects sampling density
  - `smart_sampling` boolean, nullable: Enable optimized dataset for trend analysis with faster load times

## Response `200`

Successful Response

- VolumeTelemetrySnapshotPropagationDto: Volume snapshot propagation data with appliance lists.
  - `metadata` object: Telemetry metadata (help text, metric definitions)
  - `items` VolumeTelemetrySnapshotPropagationRecord[], required: Snapshot propagation records with statistical analysis
    - `snapshot_appliance` string, required: Appliance that created the snapshot
    - `snapshot_serial_number` string, required: Serial number of the appliance that created the snapshot
    - `snapshot_time` integer, required: Timestamp in milliseconds when snapshot was created
    - `snapshot_version` integer, required: Sequential snapshot version number
    - `sync_appliance` string, required: Appliance that synced the snapshot
    - `sync_serial_number` string, required: Serial number of the appliance that synced the snapshot
    - `sync_time` integer, required: Timestamp in milliseconds when sync completed
    - `propagation_duration` integer, required: Time in milliseconds for snapshot to propagate from creation to sync completion
    - `average_propagation_duration` integer, required: Average propagation duration in milliseconds for this snapshot across all appliances
    - `deviation` integer, required: Deviation from average in milliseconds (propagation_duration - average_propagation_duration)
  - `snapshot_appliances` string[], required: List of unique appliance names that created snapshots
  - `sync_appliances` string[], required: List of unique appliance names that synced snapshots

## Other responses

- `401`: Not authenticated
- `403`: Insufficient permissions or license
- `404`: Resource not found
- `408`: Request timeout
- `413`: Payload too large
- `422`: Invalid input data
- `429`: Too many requests (rate limit exceeded)
- `500`: Internal server error

---

[API](https://skmtc.dev/nasuni/apis/portal-api.md) - [All operations](https://skmtc.dev/nasuni/apis/portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nasuni/apis/portal-api/revisions/2a505bec6d14?raw)