Documentation Index

Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

getNasVolumeInstanceRatingList

Prev Next

VPC環境で利用できます。

概要

特定の期間のNASボリュームサイズ測定リストを照会します。
KR(Korea)リージョンでのみ利用できます。他のリージョンではCloud Insight APIをご利用ください。

リクエスト

リクエストパラメータ

パラメータ名 要否 タイプ 制約事項 説明
regionCode No String - リージョンコード
サイズ測定リストを照会するNASボリュームインスタンスのリージョン(Region)を決定
regionCode:getRegionListアクションを通じて取得
デフォルト:getRegionList照会結果の最初のリージョンを選択
nasVolumeInstanceNo Yes String - サイズ測定リストを照会するNASボリュームインスタンス番号
nasVolumeInstanceNo:getNasVolumeInstanceListアクションを通じて取得
startTime Yes String yyyy-MM-dd'T'HH:mm:ssZフォーマット - 測定開始日時
GET方式を利用する場合、URLエンコードが必要
例) 2021-09-16T00:00:00+0900
endTime Yes String yyyy-MM-dd'T'HH:mm:ssZフォーマット - 測定終了日時
GET方式を利用する場合、URLエンコードが必要
例) 2021-09-18T23:59:59+0900
interval Yes String - 測定間隔
オプション:5m(5分) | 6h(6時間) | 1d(1日) | 1M(1か月)
測定間隔に応じて照会可能な最大期間(startTime~endTime)が制限される
5m最大3日
6h最大1か月
1d最大2年
1M最大5年

レスポンス

レスポンスデータのタイプ

  • NasVolumeInstanceRatingListタイプ
NasVolumeInstanceRatingList extends CommonResponse
private Integer totalRows;
private List<NasVolumeInstanceRating> nasVolumeInstanceRatingList = new ArrayList<>();
NasVolumeInstanceRating
private String ratingTime;
private Long volumeSize;
private Long volumeUseSize;
private Float volumeUseRatio;
private Long averageVolumeSize;
private Long averageVolumeUseSize;
private Float averageVolumeUseRatio;
private Long maxVolumeUseSize;
private Float maxVolumeUseRatio;
private Long minVolumeUseSize;
private Float minVolumeUseRatio;
private Long snapshotVolumeSize;
private Long snapshotVolumeUseSize;
private Float snapshotVolumeUseRatio;
private Long snapshotAverageVolumeSize;
private Long snapshotAverageVolumeUseSize;
private Float snapshotAverageVolumeUseRatio;
private Long snapshotMaxVolumeUseSize;
private Float snapshotMaxVolumeUseRatio;
private Long snapshotMinVolumeUseSize;
private Float snapshotMinVolumeUseRatio;

リクエスト例

ncloud vnas getNasVolumeInstanceRatingList --regionCode KR --nasVolumeInstanceNo ***3901 --startTime "2021-09-16T00:00:00+0900" --endTime "2021-09-16T00:05:00+0900" --interval 5m

レスポンス例

<getNasVolumeInstanceRatingListResponse>
  <requestId>ae80e33f-1414-4e54-b087-bad054f25cf2</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <nasVolumeInstanceRatingList>
    <nasVolumeInstanceRating>
      <ratingTime>2021-09-16 00:00:18.535</ratingTime>
      <volumeSize>10737418240</volumeSize>
      <volumeUseSize>458752</volumeUseSize>
      <volumeUseRatio>0.0</volumeUseRatio>
      <snapshotVolumeSize>0</snapshotVolumeSize>
      <snapshotVolumeUseSize>0</snapshotVolumeUseSize>
      <snapshotVolumeUseRatio>0.0</snapshotVolumeUseRatio>
    </nasVolumeInstanceRating>
  </nasVolumeInstanceRatingList>
</getNasVolumeInstanceRatingListResponse>