---
title: "getNasVolumeInstanceRatingList"
slug: "cli-vnas-volume-getnasvolumeinstanceratinglist"
updated: 2026-05-21T09:02:09Z
published: 2026-05-21T09:10:09Z
canonical: "cli-gov.ncloud-docs.com/cli-vnas-volume-getnasvolumeinstanceratinglist"
---

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

# getNasVolumeInstanceRatingList

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

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

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

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

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

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

## 응답<a name="응답"></a>

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

- 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; |

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

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

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

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

```xml
<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>
```