---
title: "getNasVolumeInstanceRatingList"
slug: "cli-server-getnasvolumeinstanceratinglist"
tags: ["Server", "NAS"]
updated: 2026-09-17T10:08:35Z
published: 2026-09-17T10:08:35Z
canonical: "cli.ncloud-docs.com/cli-server-getnasvolumeinstanceratinglist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getNasVolumeInstanceRatingList

## Overview

Searching NAS volume instance metrics list

## Description

Search a NAS volume instance size by days/hours/minutes/seconds.

## Request Parameters

| Parameter Name | Requiredness | Type | Limitation | Description |
| --- | --- | --- | --- | --- |
| nasVolumeInstanceNo | Yes | String |  | NAS volume instance No. You can get one by calling getNasVolumeInstanceList. |
| startTime | Yes | String | yyyy-MM-dd'T'HH:mm:ssZ format | Measurement start time yyyy-MM-dd'T'HH:mm:ssZ format (GMT) For example) 2017-07-20T00:00:00+0900 (Based on Korea) Data storage cycle : 5 Min. : 3 Days \| 6 Hours : 1 Month \| 1 Day : 2 Years \| 1 Month : 5 Years |
| endTime | Yes | String | yyyy-MM-dd'T'HH:mm:ssZ format | Measurement end time yyyy-MM-dd'T'HH:mm:ssZ format (GMT) For example) 2017-07-20T00:00:00+0900 (Based on Korea) Data storage cycle : 5 Min. : 3 Days \| 6 Hours : 1 Month \| 1 Day : 2 Years \| 1 Month : 5 Years |
| interval | Yes | String | 5m / 6h / 1d / 1M | Interval 5 Min. \| 6 Hours \| 1 Day \| 1 Month |

## Response Data Type

- NasVolumeInstanceRating type

| NasVolumeInstanceRatingList extends CommonResponse |
| --- |
| private int totalRows; |
| private List<nasvolumeinstancerating data-tomark-pass=""> nasVolumeInstanceeDataList = new ArrayList<nasvolumeinstancerating data-tomark-pass="">();</nasvolumeinstancerating></nasvolumeinstancerating> |

| NasVolumeInstanceRating |
| --- |
| private String ratingTime; |
| private Long volumeSize; |
| private Long volumeUsedSize; |
| private Float volumeUseRatio; |
| private Long averageVolumeSize; |
| private Long averageVolumeUseSize; |
| private Float averageVolumeUseRatio; |
| private Long maxVolumeUseSize; |
| private Float maxVolumeUseRatio; |
| private Long minVolumeUseSize; |
| private Float minVolumeUseRatio; |
| private Long snapshotVolumeSize; |
| private Long snapshotVolumeUseSize; |
| private Float snapshotVolumeUseRatio; |
| private Long snapshotAverageVolumeSize; |
| private Long snapshotAverageVolumeUseSize; |
| private Float snapshotAverageVolumeUseRatio; |
| private Long snapshotMaxVolumeUseSize; |
| private Float snapshotMaxVolumeUseRatio; |
| private Long snapshotMinVolumeUseSize; |
| private Float snapshotMinVolumeUseRatio; |

## Examples

### Request

```
ncloud server getNasVolumeInstanceRatingList --nasVolumeInstanceNo 397033 --startTime 2018-02-20T00:00:00+0900 --endTime 2018-02-21T00:00:00+0900 --interval 6h
```

### Response

```
{
  "getNasVolumeInstanceRatingListResponse": {
    "requestId": "7c3976d1-8fef-4bc1-93ec-1dda4c6abd21",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 2,
    "NasVolumeInstanceRatingList": [
      {
        "ratingTime": "2018-02-20 18:00:00.000",
        "averageVolumeSize": 10737418240,
        "averageVolumeUseSize": 257906,
        "averageVolumeUseRatio": 0.0,
        "maxVolumeUseSize": 258048,
        "maxVolumeUseRatio": 0.0,
        "minVolumeUseSize": 253952,
        "minVolumeUseRatio": 0.0,
        "snapshotAverageVolumeSize": 0,
        "snapshotAverageVolumeUseSize": 0,
        "snapshotMaxVolumeUseSize": 0,
        "snapshotMaxVolumeUseRatio": 0.0,
        "snapshotMinVolumeUseSize": 0,
        "snapshotMinVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2018-02-21 00:00:00.000",
        "averageVolumeSize": 10737418240,
        "averageVolumeUseSize": 258048,
        "averageVolumeUseRatio": 0.0,
        "maxVolumeUseSize": 258048,
        "maxVolumeUseRatio": 0.0,
        "minVolumeUseSize": 258048,
        "minVolumeUseRatio": 0.0,
        "snapshotAverageVolumeSize": 0,
        "snapshotAverageVolumeUseSize": 0,
        "snapshotMaxVolumeUseSize": 0,
        "snapshotMaxVolumeUseRatio": 0.0,
        "snapshotMinVolumeUseSize": 0,
        "snapshotMinVolumeUseRatio": 0.0
      }
    ]
  }
}
```

```
<?xml version="1.0" encoding="UTF-8" ?>
<getNasVolumeInstanceRatingListResponse>
  <requestId>7c3976d1-8fef-4bc1-93ec-1dda4c6abd21</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>2</totalRows>
  <NasVolumeInstanceRatingList>
    <ratingTime>2018-02-20 18:00:00.000</ratingTime>
    <averageVolumeSize>10737418240</averageVolumeSize>
    <averageVolumeUseSize>257906</averageVolumeUseSize>
    <averageVolumeUseRatio>0</averageVolumeUseRatio>
    <maxVolumeUseSize>258048</maxVolumeUseSize>
    <maxVolumeUseRatio>0</maxVolumeUseRatio>
    <minVolumeUseSize>253952</minVolumeUseSize>
    <minVolumeUseRatio>0</minVolumeUseRatio>
    <snapshotAverageVolumeSize>0</snapshotAverageVolumeSize>
    <snapshotAverageVolumeUseSize>0</snapshotAverageVolumeUseSize>
    <snapshotMaxVolumeUseSize>0</snapshotMaxVolumeUseSize>
    <snapshotMaxVolumeUseRatio>0</snapshotMaxVolumeUseRatio>
    <snapshotMinVolumeUseSize>0</snapshotMinVolumeUseSize>
    <snapshotMinVolumeUseRatio>0</snapshotMinVolumeUseRatio>
  </NasVolumeInstanceRatingList>
  <NasVolumeInstanceRatingList>
    <ratingTime>2018-02-21 00:00:00.000</ratingTime>
    <averageVolumeSize>10737418240</averageVolumeSize>
    <averageVolumeUseSize>258048</averageVolumeUseSize>
    <averageVolumeUseRatio>0</averageVolumeUseRatio>
    <maxVolumeUseSize>258048</maxVolumeUseSize>
    <maxVolumeUseRatio>0</maxVolumeUseRatio>
    <minVolumeUseSize>258048</minVolumeUseSize>
    <minVolumeUseRatio>0</minVolumeUseRatio>
    <snapshotAverageVolumeSize>0</snapshotAverageVolumeSize>
    <snapshotAverageVolumeUseSize>0</snapshotAverageVolumeUseSize>
    <snapshotMaxVolumeUseSize>0</snapshotMaxVolumeUseSize>
    <snapshotMaxVolumeUseRatio>0</snapshotMaxVolumeUseRatio>
    <snapshotMinVolumeUseSize>0</snapshotMinVolumeUseSize>
    <snapshotMinVolumeUseRatio>0</snapshotMinVolumeUseRatio>
  </NasVolumeInstanceRatingList>
</getNasVolumeInstanceRatingListResponse>
```