getNasVolumeInstanceRatingList

Article Summary

Share feedback

Thanks for sharing your feedback!

The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

Available in Classic

Overview

Gets the size of a NAS volume instance periodically (every day/hour/minute/second).

Request

Request parameters

Parameter	Required	Type	Limitations	Description
nasVolumeInstanceNo	Y	String		NAS volume instance number Get available values by using the getNasVolumeInstanceList action.
startTime	Y	String	yyyy-MM-dd'T'HH:mm:ssZ format	Rating start time It must be URL-encoded. yyyy-MM-dd'T'HH:mm:ssZ format (GMT) Example) 2017-07-20T00:00:00+0900 (KST) Data retention period: 3 days for 5 minutes \| 1 month for 6 hours \| 2 years for 1 day \| 5 years for 1 month
endTime	Y	String	yyyy-MM-dd'T'HH:mm:ssZ format	Rating end time It must be URL-encoded. yyyy-MM-dd'T'HH:mm:ssZ format (GMT) Example) 2017-07-20T00:00:00+0900 (KST) Data retention period: 3 days for 5 minutes \| 1 month for 6 hours \| 2 years for 1 day \| 5 years for 1 month
interval	Y	String	5m / 6h / 1d / 1M	Rating interval Options: 5m (5 minutes) \| 6h (6 hours) \| 1d (1 day) \| 1M (1 month)

Response

Response body

NasVolumeInstanceRating

Examples

Request example

[Before URL Encoding] 
GET {SERVER_API_URL}/getNasVolumeInstanceRatingList
?nasVolumeInstanceNo=1083118
&startTime=2018-11-26T00:00:00+0000
&endTime=2018-11-27T00:00:00+0000
&interval=1d

[After URL Encoding] 
GET {SERVER_API_URL}/getNasVolumeInstanceRatingList
?nasVolumeInstanceNo=1083118
&startTime=2018-11-26T00%3A00%3A00%2B0000
&endTime=2018-11-27T00%3A00%3A00%2B0000
&interval=1d

Response example

<getNasVolumeInstanceRatingListResponse>
  <requestId>d690e877-eadb-4821-93f0-2ee8681d0da7</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>2</totalRows>
  <nasVolumeInstanceRatingList>
    <nasVolumeInstanceRating>
      <ratingTime>20181126</ratingTime>
      <averageVolumeSize>654541248876</averageVolumeSize>
      <averageVolumeUseSize>307732</averageVolumeUseSize>
      <averageVolumeUseRatio>0.0</averageVolumeUseRatio>
      <maxVolumeUseSize>331776</maxVolumeUseSize>
      <maxVolumeUseRatio>0.0</maxVolumeUseRatio>
      <minVolumeUseSize>278528</minVolumeUseSize>
      <minVolumeUseRatio>0.0</minVolumeUseRatio>
      <snapshotAverageVolumeSize>0</snapshotAverageVolumeSize>
      <snapshotAverageVolumeUseSize>0</snapshotAverageVolumeUseSize>
      <snapshotMaxVolumeUseSize>0</snapshotMaxVolumeUseSize>
      <snapshotMaxVolumeUseRatio>0.0</snapshotMaxVolumeUseRatio>
      <snapshotMinVolumeUseSize>0</snapshotMinVolumeUseSize>
      <snapshotMinVolumeUseRatio>0.0</snapshotMinVolumeUseRatio>
    </nasVolumeInstanceRating>
    <nasVolumeInstanceRating>
      <ratingTime>20181127</ratingTime>
      <averageVolumeSize>1073741824000</averageVolumeSize>
      <averageVolumeUseSize>329993</averageVolumeUseSize>
      <averageVolumeUseRatio>0.0</averageVolumeUseRatio>
      <maxVolumeUseSize>331776</maxVolumeUseSize>
      <maxVolumeUseRatio>0.0</maxVolumeUseRatio>
      <minVolumeUseSize>315392</minVolumeUseSize>
      <minVolumeUseRatio>0.0</minVolumeUseRatio>
      <snapshotAverageVolumeSize>0</snapshotAverageVolumeSize>
      <snapshotAverageVolumeUseSize>0</snapshotAverageVolumeUseSize>
      <snapshotMaxVolumeUseSize>0</snapshotMaxVolumeUseSize>
      <snapshotMaxVolumeUseRatio>0.0</snapshotMaxVolumeUseRatio>
      <snapshotMinVolumeUseSize>0</snapshotMinVolumeUseSize>
      <snapshotMinVolumeUseRatio>0.0</snapshotMinVolumeUseRatio>
    </nasVolumeInstanceRating>
  </nasVolumeInstanceRatingList>
</getNasVolumeInstanceRatingListResponse>

Error codes

Errors that may occur while using this action are listed below. For information on common errors, refer to NAVER Cloud Platform API.

HTTP response code	Return code	Return message
400	41105	period of data acquisition which can be set are 5 min(5m), 6 hours(6h), 1 day(1d) and 1 month(1M).
400	41106	Statistics data of each period is stored for the following terms. 5 min(5m), stored up to 3 days.6 hours(6h), stored up to 1 month. 1 day(1d), stored up to 2 years.1 month(1M), stored up to 5 years.
400	41107	When checking statistics data, Invalid date format entered. yyyy-MM-dd'T'HH:mm:ssZ[API] / yyyy-MM-dd HH:mm:ss[MC]

Was this article helpful?

What's Next

getNasVolumeSnapshotConfigurationHistoryList

Table of contents

Overview
Request
Response
Examples
Error codes