---
title: "getNasVolumeInstanceRatingList"
slug: "cli-vnas-volume-getnasvolumeinstanceratinglist"
tags: ["NAS", "Volume"]
updated: 2026-09-17T09:10:37Z
published: 2026-09-17T09:10: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 볼륨 인스턴스의 크기를 설정한 측정 간격에 따라 조회합니다.

## 구문

`getNasVolumeInstanceRatingList` 구문은 다음과 같습니다.

```
./ncloud vnas getNasVolumeInstanceRatingList \
    --nasVolumeInstanceNo <nas-volume-instance-no> \
    --startTime <start-time> \
    --endTime <end-time> \
    --interval <5m|6h|1d|1M> \
    [--regionCode <FKR>] \
    [--output <json|xml>]
```

## 옵션

`getNasVolumeInstanceRatingList` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`getNasVolumeInstanceRatingList`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--nasVolumeInstanceNo` | String | Required | NAS 볼륨 인스턴스 번호 - [getNasVolumeInstanceList](/docs/cli-vnas-volume-getnasvolumeinstancelist) 참조 |
| `--startTime` | String | Required | 측정 시작 일시 - yyyy-MM-dd'T'HH:mm:ssZ 형식 (예시: `2026-04-01T00:00:00+0900`) |
| `--endTime` | String | Required | 측정 종료 일시 - yyyy-MM-dd'T'HH:mm:ssZ 형식 (예시: `2026-04-01T23:59:59+0900`) |
| `--interval` | String | Required | 측정 간격 - `5m` \| `6h` \| `1d` \| `1M` - `5m`: 5분 - `6h`: 6시간 - `1d`: 1일 - `1M`: 1개월 - 측정 간격에 따라 최대 조회 기간(`startTime`~`endTime`) 제한 - `5m`: 최대 3일 - `6h`: 최대 1개월 - `1d`: 최대 2년 - `1M`: 최대 5년 |

### 공통 옵션

`vnas` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [NAS 옵션](/docs/cli-vnas#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

NAS 볼륨 측정 목록 조회 요청이 성공하면 각 측정 시점의 볼륨 사용량 정보와 스냅샷 사용량 정보가 반환됩니다. 반환되는 항목은 `interval` 값에 따라 달라집니다.

### 명령

`5m` 간격으로 조회하는 명령 예시는 다음과 같습니다.

```
./ncloud vnas getNasVolumeInstanceRatingList \
    --nasVolumeInstanceNo 34567890 \
    --startTime "2026-08-26T11:30:00+0900" \
    --endTime "2026-08-26T12:00:00+0900" \
    --interval 5m \
    --regionCode FKR \
    --output json
```

`6h` 간격으로 조회하는 명령 예시는 다음과 같습니다.

```
./ncloud vnas getNasVolumeInstanceRatingList \
    --nasVolumeInstanceNo 34567890 \
    --startTime "2026-08-26T00:00:00+0900" \
    --endTime "2026-08-26T23:59:59+0900" \
    --interval 6h \
    --regionCode FKR \
    --output json
```

### 출력

`5m` 간격으로 조회한 출력 예시는 다음과 같습니다. 측정 시점의 볼륨 사용량이 반환됩니다.

```
{
  "getNasVolumeInstanceRatingListResponse": {
    "totalRows": 6,
    "nasVolumeInstanceRatingList": [
      {
        "ratingTime": "2026-08-26 11:30:53.296",
        "volumeSize": 536870912000,
        "volumeUseSize": 360448,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-26 11:37:11.292",
        "volumeSize": 644245094400,
        "volumeUseSize": 380928,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-26 11:42:12.499",
        "volumeSize": 644245094400,
        "volumeUseSize": 380928,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-26 11:45:53.220",
        "volumeSize": 644245094400,
        "volumeUseSize": 380928,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-26 11:52:17.503",
        "volumeSize": 644245094400,
        "volumeUseSize": 380928,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-26 11:55:54.341",
        "volumeSize": 644245094400,
        "volumeUseSize": 380928,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      }
    ],
    "requestId": "255edc71-44c3-4c5b-b06c-747847e3dc0f",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

`6h` 간격으로 조회한 출력 예시는 다음과 같습니다. 측정 구간의 평균·최대·최소 사용량이 반환됩니다.

```
{
  "getNasVolumeInstanceRatingListResponse": {
    "totalRows": 1,
    "nasVolumeInstanceRatingList": [
      {
        "ratingTime": "2026-08-26 12:00:00.000",
        "averageVolumeSize": 644245094400,
        "averageVolumeUseSize": 408780,
        "averageVolumeUseRatio": 0.0,
        "maxVolumeUseSize": 413696,
        "maxVolumeUseRatio": 0.0,
        "minVolumeUseSize": 401408,
        "minVolumeUseRatio": 0.0,
        "snapshotAverageVolumeSize": 0,
        "snapshotAverageVolumeUseSize": 0,
        "snapshotMaxVolumeUseSize": 0,
        "snapshotMaxVolumeUseRatio": 0.0,
        "snapshotMinVolumeUseSize": 0,
        "snapshotMinVolumeUseRatio": 0.0
      }
    ],
    "requestId": "fb736a0d-c003-413b-bb8e-d92c9fd6710b",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```