---
title: "getNasVolumeInstanceRatingList"
slug: "cli-vnas-volume-getnasvolumeinstanceratinglist"
updated: 2026-04-23T09:05:01Z
published: 2026-04-23T09:07:37Z
canonical: "cli-fin.ncloud-docs.com/cli-vnas-volume-getnasvolumeinstanceratinglist"
---

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

# getNasVolumeInstanceRatingList

## 개요

특정 기간의 NAS 볼륨 사이즈 측정 리스트를 조회합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 사이즈 측정 리스트를 조회할 NAS 볼륨 인스턴스의 리전(Region) 결정 regionCode : [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 Default : getRegionList 조회 결과의 첫 번째 리전 선택 |
| nasVolumeInstanceNo | Yes | String |  | - 사이즈 측정 리스트를 조회할 NAS 볼륨 인스턴스 번호 nasVolumeInstanceNo : [getNasVolumeInstanceList](/docs/cli-vnas-volume-getnasvolumeinstancelist) 액션을 통해 획득 |
| startTime | Yes | String | yyyy-MM-dd'T'HH:mm:ssZ 포맷 | - 측정 시작 일시 GET 방식 이용시 URL 인코딩 필요 ex) 2021-09-16T00:00:00+0900 |
| endTime | Yes | String | yyyy-MM-dd'T'HH:mm:ssZ 포맷 | - 측정 종료 일시 GET 방식 이용시 URL 인코딩 필요 ex) 2021-09-18T23:59:59+0900 |
| interval | Yes | String |  | - 측정 간격 Options : 5m (5분) \| 6h (6시간) \| 1d (1일) \| 1M (1개월) 측정 간격에 따라서 최대로 조회할 수 있는 기간 (startTime ~ endTime) 이 제한됨 `5m` : `최대 3일` `6h` : `최대 1개월` `1d` : `최대 2년` `1M` : `최대 5년` |

## 응답

### 응답 데이터 타입

- NasVolumeInstanceRatingList 타입

| NasVolumeInstanceRatingList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<NasVolumeInstanceRating> nasVolumeInstanceRatingList = new ArrayList<>(); |

| NasVolumeInstanceRating |
| --- |
| private String ratingTime; |
| private Long volumeSize; |
| private Long volumeUseSize; |
| 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; |

## 예시

### 요청 예시

```
ncloud vnas getNasVolumeInstanceRatingList --regionCode FKR --nasVolumeInstanceNo ***3901 --startTime "2021-09-16T00:00:00+0900" --endTime "2021-09-16T00:05:00+0900" --interval 5m
```

### 응답 예시

```
<getNasVolumeInstanceRatingListResponse>
  <requestId>ae80e33f-1414-4e54-b087-bad054f25cf2</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <nasVolumeInstanceRatingList>
    <nasVolumeInstanceRating>
      <ratingTime>2021-09-16 00:00:18.535</ratingTime>
      <volumeSize>10737418240</volumeSize>
      <volumeUseSize>458752</volumeUseSize>
      <volumeUseRatio>0.0</volumeUseRatio>
      <snapshotVolumeSize>0</snapshotVolumeSize>
      <snapshotVolumeUseSize>0</snapshotVolumeUseSize>
      <snapshotVolumeUseRatio>0.0</snapshotVolumeUseRatio>
    </nasVolumeInstanceRating>
  </nasVolumeInstanceRatingList>
</getNasVolumeInstanceRatingListResponse>
```