CDN 모니터링 데이터 조회
    • PDF

    CDN 모니터링 데이터 조회

    • PDF

    기사 요약

    개요

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

    요청

    요청 파라미터

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

    응답

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

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

    속성

    항목필수 여부타입설명
    startDateNoString조회시작일시 'yyyyMMddHHmm'
    endDateNoString조회종료일시 'yyyyMMddHHmm'
    startDateEpochNoLong조회시작일시 EpochTime
    endDateEpochNoLong조회종료일시 EpochTime
    intervalNoLong응답 데이터의 Aggregation 시간 정보
    2일 이내: 5분
    2일 초과 -일주일 이내: 30분
    일주일 초과-1개월 이내: 2시간
    1개월 초과-3개월 이내: 6시간
    bandwidthDataUnitNoStringEdge 트래픽 단위 (bps)
    bandwidthDataRecordListNoList<List<Double>>트래픽 데이터 목록
    volumeDataUnitNoStringEdge 전송량 단위 (byte)
    volumeDataRecordListNoList<List<Long>>전송량 데이터 목록
    requestDataUnitNoLongEdge 요청 단위 (건수)
    requestDataRecordListNoList<List<Long>>요청수 데이터 목록
    offloadDataUnitNoString히트율 단위 (%)
    offloadDataRecordListNoList<List<Double>>히트율 데이터 목록
    xxxEdgeHitsDataUnitNoStringEdge 응답코드별 수 단위 (건수)
    twoxxEdgeHitsDataRecordListNoList<List<Long>>2xx 응답코드 수
    threexxEdgeHitsDataRecordListNoList<List<Long>>3xx 응답코드 수
    fourxxEdgeHitsDataRecordListNoList<List<Long>>4xx 응답코드 수
    fivexxEdgeHitsDataRecordListNoList<List<Long>>5xx 응답코드 수
    originBandwidthDataUnitNoString원본 트래픽 단위(bps)
    originBandwidthDataRecordListNoList<List<Double>>트래픽 데이터 목록
    xxxOriginHitsDataUnitNoString원본 요청 수 단위 (건수)
    twoxxOriginHitsDataRecordListNoList<List<Long>>2xx 응답코드 수
    threexxOriginHitsDataRecordListNoList<List<Long>>3xx 응답코드 수
    fourxxOriginHitsDataRecordListNoList<List<Long>>4xx 응답코드 수
    fivexxOriginHitsDataRecordListNoList<List<Long>>5xx 응답코드 수
    maxBandwidthNoDouble기간 내 최대 Edge 트래픽
    totalVolumeNoLong기간 내 총 전송량
    totalRequestNoLong기간 내 총 요청수
    maxOffloadNoDouble기간 내 최대 히트율(%)
    totalTwoxxEdgeHitsNoLong기간 내 Edge의 총 2xx 응답코드 수
    totalThreexxEdgeHitsNoLong기간 내 Edge의 총 3xx 응답코드 수
    totalFourxxEdgeHitsNoLong기간 내 Edge의 총 4xx 응답코드 수
    totalFivexxEdgeHitsNoLong기간 내 Edge의 총 5xx 응답코드 수
    maxOriginBandwidthNoDouble기간 내 최대 원본 트래픽
    totalTwoxxOriginHitsNoLong기간 내 원본의 총 2xx 응답코드 수
    totalThreexxOriginHitsNoLong기간 내 원본의 총 3xx 응답코드 수
    totalFourxxOriginHitsNoLong기간 내 원본의 총 4xx 응답코드 수
    totalFivexxOriginHitsNoLong기간 내 원본의 총 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 코드설명
    29200Invalid CDN rule.
    29201Can not operate this CDN service. Please check status.
    29202Invalid CDN purge request.
    29203Invalid CDN service domain type code.
    29204Invalid CDN instance.
    29205Unable to control the CDN service because this CDN service is for Live Transcoder.
    29211An error occurred while creating CDN service.
    29215This CDN service can not request purge with partial domains.
    29216Invalid CDN service domain.
    29209The certificate can not register for CDN.
    29217Please enter target file list or directory.
    29218Please select target service domains.
    29221Unable to control the CDN service because this CDN service is for Image Optimizer.
    29222Invalid image optimizer instance number.
    29223Cache Key Hostname can not be set Origin Hostname if there is only one service domain.
    29224Cache Key Hostname can not be set Origin Hostname if use CDN domain.

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.