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의 필수 옵션입니다.

공통 옵션

vnas 명령에서 공통으로 사용하는 옵션에 대한 정보는 NAS 옵션을 참조해 주십시오.

예시

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"
  }
}