---
title: "Get Appliance CoW Disk IO Latency"
method: POST
path: "/telemetry/appliances/{serial_number}/cow_disk_io_latency"
tags: ["Ops IQ"]
---

# Get Appliance CoW Disk IO Latency

`POST /telemetry/appliances/{serial_number}/cow_disk_io_latency`

## Request

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

Get CoW disk IO latency telemetry for an appliance.

## Path parameters

- `serial_number` string, uuid, required

## Request body

- ApplianceTelemetryRequestDto: Request DTO for appliance telemetry data (filer_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.
  - `panel_width` integer, nullable: Panel width in pixels (100-5200)
  - `bin_size` integer, nullable: Bin size for data aggregation (60-3600)

## Response `200`

Successful Response

- ApplianceTelemetryCowDiskIoLatencyDto: CoW disk IO latency response with embedded metadata
  - `metadata` object: Telemetry metadata (help text, metric definitions)
  - `items` ApplianceTelemetryDiskIoLatencyRecord[], required: List of disk IO latency records
    - `time` integer, required: Timestamp in milliseconds
    - `read_latency` string, nullable: Average read latency in milliseconds for the disk
    - `write_latency` string, nullable: Average write latency in milliseconds for the disk

## 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)