---
title: "getNasVolumeInstanceRatingList"
slug: "cli-vnas-volume-getnasvolumeinstanceratinglist"
tags: ["Volume", "NAS"]
updated: 2026-10-22T09:07:27Z
published: 2026-10-22T09:07:27Z
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

VPC 환경에서 이용 가능합니다.

특정 기간의 NAS 볼륨 인스턴스의 크기를 설정한 측정 간격에 따라 조회합니다.

## 구문

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

```
./ncloud vnas getNasVolumeInstanceRatingList \
    --nasVolumeInstanceNo <nas-volume-instance-no> \
    --startTime <start-time> \
    --endTime <end-time> \
    --interval <5m|6h|1d|1M> \
    [--regionCode <KR|KRS>] \
    [--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 (VPC) 옵션](/docs/cli-vnas#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

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

### 명령

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

```
./ncloud vnas getNasVolumeInstanceRatingList \
    --nasVolumeInstanceNo 34567890 \
    --startTime "2026-08-24T16:00:00+0900" \
    --endTime "2026-08-24T17:30:00+0900" \
    --interval 5m \
    --regionCode KR \
    --output json
```

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

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

### 출력

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

```
{
  "getNasVolumeInstanceRatingListResponse": {
    "totalRows": 6,
    "nasVolumeInstanceRatingList": [
      {
        "ratingTime": "2026-08-24 17:04:38.889",
        "volumeSize": 107374182400,
        "volumeUseSize": 380928,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-24 17:09:36.447",
        "volumeSize": 107374182400,
        "volumeUseSize": 380928,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-24 17:14:41.107",
        "volumeSize": 107374182400,
        "volumeUseSize": 389120,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-24 17:19:36.564",
        "volumeSize": 107374182400,
        "volumeUseSize": 389120,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-24 17:24:37.529",
        "volumeSize": 107374182400,
        "volumeUseSize": 389120,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-24 17:29:37.103",
        "volumeSize": 107374182400,
        "volumeUseSize": 454656,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 0,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      }
    ],
    "requestId": "63fa956d-48f0-4df5-87ed-3841234f8d1c",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

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

```
{
  "getNasVolumeInstanceRatingListResponse": {
    "totalRows": 1,
    "nasVolumeInstanceRatingList": [
      {
        "ratingTime": "2026-08-24 18:00:00.000",
        "averageVolumeSize": 107374182400,
        "averageVolumeUseSize": 479744,
        "averageVolumeUseRatio": 0.0,
        "maxVolumeUseSize": 487424,
        "maxVolumeUseRatio": 0.0,
        "minVolumeUseSize": 430080,
        "minVolumeUseRatio": 0.0,
        "snapshotAverageVolumeSize": 0,
        "snapshotAverageVolumeUseSize": 0,
        "snapshotMaxVolumeUseSize": 0,
        "snapshotMaxVolumeUseRatio": 0.0,
        "snapshotMinVolumeUseSize": 0,
        "snapshotMinVolumeUseRatio": 0.0
      }
    ],
    "requestId": "f452e1fa-aa52-4f6a-829c-bcee1355d1e7",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```