CDN 모니터링 데이터 조회

Prev Next

개요

CDN+ 모니터링 데이터를 조회합니다.

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
cdnInstanceNoList.N Yes List<String> CDN 인스턴스 번호 리스트
cdnInstanceNoList.1=2323
startDate Yes String 형식은 'yyyyMMddHHmm' 조회 시작 일시
endDate Yes String 형식은 'yyyyMMddHHmm' 조회 종료 일시
regionNo No String 리전 번호: 작성하지 않을 KR 리전이 default
responseFormatType No String JSON 또는 XML 응답 타입

응답

모든 응답은 HTTP Status Code으로 성공/실패를 반환합니다.

HTTP 상태 코드 코드 메시지 설명
200 Success 조회 성공
401 Unauthorized 인증 실패
500 Internal Server Error 서버 오류

속성

항목 필수 여부 타입 설명
startDate No String 조회시작일시 'yyyyMMddHHmm'
endDate No String 조회종료일시 'yyyyMMddHHmm'
startDateEpoch No Long 조회시작일시 EpochTime
endDateEpoch No Long 조회종료일시 EpochTime
interval No Long 응답 데이터의 Aggregation 시간 정보
2일 이내: 5분
2일 초과 -일주일 이내: 30분
일주일 초과-1개월 이내: 2시간
1개월 초과-3개월 이내: 6시간
bandwidthDataUnit No String Edge 트래픽 단위 (bps)
bandwidthDataRecordList No List<List<Double>> 트래픽 데이터 목록
volumeDataUnit No String Edge 전송량 단위 (byte)
volumeDataRecordList No List<List<Long>> 전송량 데이터 목록
requestDataUnit No Long Edge 요청 단위 (건수)
requestDataRecordList No List<List<Long>> 요청수 데이터 목록
offloadDataUnit No String 히트율 단위 (%)
offloadDataRecordList No List<List<Double>> 히트율 데이터 목록
xxxEdgeHitsDataUnit No String Edge 응답코드별 수 단위 (건수)
twoxxEdgeHitsDataRecordList No List<List<Long>> 2xx 응답코드 수
threexxEdgeHitsDataRecordList No List<List<Long>> 3xx 응답코드 수
fourxxEdgeHitsDataRecordList No List<List<Long>> 4xx 응답코드 수
fivexxEdgeHitsDataRecordList No List<List<Long>> 5xx 응답코드 수
originBandwidthDataUnit No String 원본 트래픽 단위(bps)
originBandwidthDataRecordList No List<List<Double>> 트래픽 데이터 목록
xxxOriginHitsDataUnit No String 원본 요청 수 단위 (건수)
twoxxOriginHitsDataRecordList No List<List<Long>> 2xx 응답코드 수
threexxOriginHitsDataRecordList No List<List<Long>> 3xx 응답코드 수
fourxxOriginHitsDataRecordList No List<List<Long>> 4xx 응답코드 수
fivexxOriginHitsDataRecordList No List<List<Long>> 5xx 응답코드 수
maxBandwidth No Double 기간 내 최대 Edge 트래픽
totalVolume No Long 기간 내 총 전송량
totalRequest No Long 기간 내 총 요청수
maxOffload No Double 기간 내 최대 히트율(%)
totalTwoxxEdgeHits No Long 기간 내 Edge의 총 2xx 응답코드 수
totalThreexxEdgeHits No Long 기간 내 Edge의 총 3xx 응답코드 수
totalFourxxEdgeHits No Long 기간 내 Edge의 총 4xx 응답코드 수
totalFivexxEdgeHits No Long 기간 내 Edge의 총 5xx 응답코드 수
maxOriginBandwidth No Double 기간 내 최대 원본 트래픽
totalTwoxxOriginHits No Long 기간 내 원본의 총 2xx 응답코드 수
totalThreexxOriginHits No Long 기간 내 원본의 총 3xx 응답코드 수
totalFourxxOriginHits No Long 기간 내 원본의 총 4xx 응답코드 수
totalFivexxOriginHits No Long 기간 내 원본의 총 5xx 응답코드 수

예시

요청 예시

https://ncloud.apigw.gov-ntruss.com/cdn/v2/getCdnPlusMonitoringData?cdnInstanceNoList.1=431411&startDate=202209010000&endDate=202209010010&responseFormatType=XML

응답 예시

<?xml version="1.0" encoding="UTF-8"?>
  <getCdnPlusMonitoringDataResponse>
    <requestId>f23c982b-e41a-47f9-9b47-c2249d1bb5ea</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <startDate>202209010000</startDate>
    <endDate>202209010010</endDate>
    <startDateEpoch>1661958000000</startDateEpoch>
    <endDateEpoch>1661958600000</endDateEpoch>
    <interval>300000</interval>
    <bandwidthDataUnit>bps</bandwidthDataUnit>
    <bandwidthDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </bandwidthDataRecordList>
    <volumeDataUnit>byte</volumeDataUnit>
    <volumeDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </volumeDataRecordList>
    <requestDataUnit>count</requestDataUnit>
    <requestDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </requestDataRecordList>
    <offloadDataUnit>percentage</offloadDataUnit>
    <offloadDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </offloadDataRecordList>
    <xxxEdgeHitsDataUnit>count</xxxEdgeHitsDataUnit>
    <twoxxEdgeHitsDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </twoxxEdgeHitsDataRecordList>
    <threexxEdgeHitsDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </threexxEdgeHitsDataRecordList>
    <fourxxEdgeHitsDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </fourxxEdgeHitsDataRecordList>
    <fivexxEdgeHitsDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </fivexxEdgeHitsDataRecordList>
    <originBandwidthDataUnit>bps</originBandwidthDataUnit>
    <originBandwidthDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </originBandwidthDataRecordList>
    <xxxOriginHitsDataUnit>count</xxxOriginHitsDataUnit>
    <twoxxOriginHitsDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </twoxxOriginHitsDataRecordList>
    <threexxOriginHitsDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </threexxOriginHitsDataRecordList>
    <fourxxOriginHitsDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </fourxxOriginHitsDataRecordList>
    <fivexxOriginHitsDataRecordList>
      <list>
        <long>1661958000000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958300000</long>
        <int>0</int>
      </list>
      <list>
        <long>1661958600000</long>
        <int>0</int>
      </list>
    </fivexxOriginHitsDataRecordList>
    <maxBandwidth>0.0</maxBandwidth>
    <totalVolume>0</totalVolume>
    <totalRequest>0</totalRequest>
    <maxOffload>0.0</maxOffload>
    <totalTwoxxEdgeHits>0</totalTwoxxEdgeHits>
    <totalThreexxEdgeHits>0</totalThreexxEdgeHits>
    <totalFourxxEdgeHits>0</totalFourxxEdgeHits>
    <totalFivexxEdgeHits>0</totalFivexxEdgeHits>
    <maxOriginBandwidth>0.0</maxOriginBandwidth>
    <totalTwoxxOriginHits>0</totalTwoxxOriginHits>
    <totalThreexxOriginHits>0</totalThreexxOriginHits>
    <totalFourxxOriginHits>0</totalFourxxOriginHits>
    <totalFivexxOriginHits>0</totalFivexxOriginHits>
  </getCdnPlusMonitoringDataResponse>

오류 코드

Error 코드 설명
29200 Invalid CDN rule.
29201 Can not operate this CDN service. Please check status.
29202 Invalid CDN purge request.
29203 Invalid CDN service domain type code.
29204 Invalid CDN instance.
29205 Unable to control the CDN service because this CDN service is for Live Transcoder.
29211 An error occurred while creating CDN service.
29215 This CDN service can not request purge with partial domains.
29216 Invalid CDN service domain.
29209 The certificate can not register for CDN.
29217 Please enter target file list or directory.
29218 Please select target service domains.
29221 Unable to control the CDN service because this CDN service is for Image Optimizer.
29222 Invalid image optimizer instance number.
29223 Cache Key Hostname can not be set Origin Hostname if there is only one service domain.
29224 Cache Key Hostname can not be set Origin Hostname if use CDN domain.