getNasVolumeInstanceRatingList

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

특정 기간의 NAS 볼륨 인스턴스의 크기를 설정한 측정 간격에 따라 조회합니다. getNasVolumeInstanceRatingList는 한국(KR) 리전에서만 이용할 수 있습니다. 다른 리전에서 NAS 볼륨 인스턴스 측정 목록을 조회하려면 Cloud Insight API를 참조해 주십시오.

구문

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

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

옵션

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

필수 옵션

getNasVolumeInstanceRatingList의 필수 옵션입니다.

공통 옵션

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

예시

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

명령

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

./ncloud vnas getNasVolumeInstanceRatingList \
    --nasVolumeInstanceNo 10234567 \
    --startTime "2026-08-19T11:45:00+0900" \
    --endTime "2026-08-19T12:00:00+0900" \
    --interval 5m \
    --regionCode KR \
    --output json

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

./ncloud vnas getNasVolumeInstanceRatingList \
    --nasVolumeInstanceNo 10234567 \
    --startTime "2026-08-19T00:00:00+0900" \
    --endTime "2026-08-19T23:59:59+0900" \
    --interval 6h \
    --regionCode KR \
    --output json

출력

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

{
  "getNasVolumeInstanceRatingListResponse": {
    "totalRows": 3,
    "nasVolumeInstanceRatingList": [
      {
        "ratingTime": "2026-08-19 11:46:29.549",
        "volumeSize": 483183820800,
        "volumeUseSize": 401408,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 53687091200,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-19 11:51:17.455",
        "volumeSize": 483183820800,
        "volumeUseSize": 401408,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 53687091200,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-19 11:56:02.254",
        "volumeSize": 483183820800,
        "volumeUseSize": 401408,
        "volumeUseRatio": 0.0,
        "snapshotVolumeSize": 53687091200,
        "snapshotVolumeUseSize": 0,
        "snapshotVolumeUseRatio": 0.0
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

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

{
  "getNasVolumeInstanceRatingListResponse": {
    "totalRows": 2,
    "nasVolumeInstanceRatingList": [
      {
        "ratingTime": "2026-08-19 06:00:00.000",
        "averageVolumeSize": 483183820800,
        "averageVolumeUseSize": 401408,
        "averageVolumeUseRatio": 0.0,
        "maxVolumeUseSize": 401408,
        "maxVolumeUseRatio": 0.0,
        "minVolumeUseSize": 401408,
        "minVolumeUseRatio": 0.0,
        "snapshotAverageVolumeSize": 53687091200,
        "snapshotAverageVolumeUseSize": 0,
        "snapshotMaxVolumeUseSize": 0,
        "snapshotMaxVolumeUseRatio": 0.0,
        "snapshotMinVolumeUseSize": 0,
        "snapshotMinVolumeUseRatio": 0.0
      },
      {
        "ratingTime": "2026-08-19 12:00:00.000",
        "averageVolumeSize": 483183820800,
        "averageVolumeUseSize": 481776,
        "averageVolumeUseRatio": 0.0,
        "maxVolumeUseSize": 499712,
        "maxVolumeUseRatio": 0.0,
        "minVolumeUseSize": 409600,
        "minVolumeUseRatio": 0.0,
        "snapshotAverageVolumeSize": 53687091200,
        "snapshotAverageVolumeUseSize": 0,
        "snapshotMaxVolumeUseSize": 0,
        "snapshotMaxVolumeUseRatio": 0.0,
        "snapshotMinVolumeUseSize": 0,
        "snapshotMinVolumeUseRatio": 0.0
      }
    ],
    "requestId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "returnCode": "0",
    "returnMessage": "success"
  }
}