Documentation Index

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

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

getNasVolumeInstanceRatingList

Prev Next

개요

특정 기간의 NAS 볼륨 사이즈 측정 리스트를 조회합니다.

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
regionCode No String - 리전 코드
사이즈 측정 리스트를 조회할 NAS 볼륨 인스턴스의 리전(Region) 결정
regionCode : getRegionList 액션을 통해 획득
Default : getRegionList 조회 결과의 첫 번째 리전 선택
nasVolumeInstanceNo Yes String - 사이즈 측정 리스트를 조회할 NAS 볼륨 인스턴스 번호
nasVolumeInstanceNo : getNasVolumeInstanceList 액션을 통해 획득
startTime Yes String yyyy-MM-dd'T'HH:mm:ssZ 포맷 - 측정 시작 일시
GET 방식 이용시 URL 인코딩 필요
ex) 2021-09-16T00:00:00+0900
endTime Yes String yyyy-MM-dd'T'HH:mm:ssZ 포맷 - 측정 종료 일시
GET 방식 이용시 URL 인코딩 필요
ex) 2021-09-18T23:59:59+0900
interval Yes String - 측정 간격
Options : 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 FKR --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>