---
title: "getNasVolumeInstanceRatingList"
slug: "cli-server-getnasvolumeinstanceratinglist"
updated: 2026-04-23T08:56:59Z
published: 2026-04-23T08:58:53Z
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

## 개요<a name="개요"></a>

NAS 볼륨 인스턴스 측정 리스트 조회

## 설명 <a name="설명"></a>

일/시간/분/초 단위로 NAS 볼륨의 인스턴스의 크기를 조회합니다.

## 요청 파라미터 <a name="요청파라미터"></a>

| 파라미터 명         | 필수   여부 | 타입   | 제약사항                    | 설명                                                         |
| ------------------- | ----------- | ------ | --------------------------- | ------------------------------------------------------------ |
| nasVolumeInstanceNo | Yes         | String |                             | - NAS 볼륨 인스턴스 번호<br>getNasVolumeInstanceList   액션을 통해서 획득 가능 |
| startTime           | Yes         | String | yyyy-MM-dd'T'HH:mm:ssZ 포맷 | - 측정 시작 시간<br>yyyy-MM-dd'T'HH:mm:ssZ 포맷 (GMT)<br>ex)   2017-07-20T00:00:00+0900 (한국 기준)<br>데이터 보관 주기 : 5분 : 3일 \| 6시간 :   1달 \| 1일 : 2년 \| 1달 : 5년 |
| endTime             | Yes         | String | yyyy-MM-dd'T'HH:mm:ssZ 포맷 | - 측정 종료 시간<br>yyyy-MM-dd'T'HH:mm:ssZ 포맷 (GMT)<br>ex)   2017-07-20T00:00:00+0900 (한국 기준)<br>데이터 보관 주기 : 5분 : 3일 \| 6시간 :   1달 \| 1일 : 2년 \| 1달 : 5년 |
| interval            | Yes         | String | 5m / 6h / 1d / 1M           | - 측정 간격<br>5분(5m) \| 6시간(6h) \| 1일(1d)   \| 1달(1M)   |

## 응답 데이터 타입 <a name="응답데이터타입"></a>

- NasVolumeInstanceRating 타입

| NasVolumeInstanceRatingList extends CommonResponse |
| ---------------------------------------- |
| private int totalRows;
| private List<NasVolumeInstanceRating> nasVolumeInstanceeDataList = new ArrayList<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;     |

## 예시 <a name="예시"></a>

### 호출 <a name="호출"></a>

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

### 응답 <a name="응답"></a>
 
```json
{
  "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
<?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>
```