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

    CDN 모니터링 데이터 조회

    • PDF

    기사 요약

    개요

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

    요청

    요청 파라미터

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

    응답

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

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

    속성

    항목필수 여부타입설명
    startDateNoString조회시작일시 'yyyyMMddHH'
    endDateNoString조회종료일시 'yyyyMMddHH'
    aggregationNoLong응답 데이터의 Aggregation 시간 정보 (초 단위)
    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 응답 코드 수
    pointStartNoLong조회 시작 시각
    pointIntervalNoLongaggregation (밀리 세컨드 단위)
    maxBandwidthNoDouble기간 내 최대 Edge 트래픽
    totalVolumeNoLong기간 내 총 전송량
    totalRequestNoLong기간 내 총 요청수
    maxOffloadNoDouble기간 내 최대 히트율(%)
    totalTwoxxEdgeHitsNoLong기간 내 Edge의 총 2xx 응답 코드 수
    totalThreexxEdgeHitsNoLong기간 내 Edge의 총 3xx 응답 코드 수
    totalFourxxEdgeHitsNoLong기간 내 Edge의 총 4xx 응답 코드 수
    totalFivexxEdgeHitsNoLong기간 내 Edge의 총 5xx 응답 코드 수

    예시

    요청 예시

    https://ncloud.apigw.gov-ntruss.com/cdn/v2/getGlobalCdnMonitoringData?cdnInstanceNoList.1=393396&startDate=2022090100&endDate=2022090223&responseFormatType=XML
    

    응답 예시

    <?xml version="1.0" encoding="UTF-8"?>
      <getGlobalCdnMonitoringDataResponse>
        <requestId>f7e02ce8-afe5-42f7-b8b5-c100eed73c65</requestId>
        <returnCode>0</returnCode>
        <returnMessage>success</returnMessage>
        <startDate>2022090100</startDate>
        <endDate>2022090223</endDate>
        <aggregation>3600</aggregation>
        <volumeDataRecordList/>
        <requestDataRecordList/>
        <bandwidthDataRecordList/>
        <offloadDataRecordList/>
        <twoxxEdgeHitsDataRecordList/>
        <threexxEdgeHitsDataRecordList/>
        <fourxxEdgeHitsDataRecordList/>
        <fivexxEdgeHitsDataRecordList/>
        <volumeDataUnit>bytes</volumeDataUnit>
        <requestDataUnit>count</requestDataUnit>
        <bandwidthDataUnit>Mbps</bandwidthDataUnit>
        <offloadDataUnit>percent</offloadDataUnit>
        <xxxEdgeHitsDataUnit>count</xxxEdgeHitsDataUnit>
        <pointStart>1661958000000</pointStart>
        <pointInterval>3600000</pointInterval>
        <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>
      </getGlobalCdnMonitoringDataResponse>
    

    오류 코드

    Error 코드설명
    29100Invalid Global CDN rule format.
    29101Can not operate this Global CDN service. Please check status.
    29102Invalid Global CDN purge request.
    29103Invalid Global CDN service domain type code.
    29104Please enter Forward Host Header.
    29105Invalid Origin server.
    29106Invalid Origin server ports.
    29107Invalid Origin File Storage.
    29108Please enter Referrer Domain.
    29109Invalid service name.
    29110Please enter service domain.
    29111Invalid service domain.
    29112Invalid Global CDN instance.
    29113Only HTTP protocol is allowed when Origin is File Storage.
    29114This domain can not set as origin.
    29115For HTTPS protocol, only CDN domain can be set.
    29116An error occurred in purge request.
    29117Invalid origin path.
    29118Invalid referrer domain.
    29119Invalid rule for access log.
    29120Invalid Forward Host Header.
    29121Referrer Domains can be added up to 50.
    29122Can not request purge for the CDN service. Please check status.
    29123The purge function can only be used after about 3 hours after the creation request is made.
    29124There is an error in the service domain name entered during the purge request.

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

    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.