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>