MENU
      CDN 사용량 조회
        • PDF

        CDN 사용량 조회

        • PDF

        기사 요약

        개요

        CDN+ 사용량 데이터를 조회합니다.

        요청

        요청 파라미터

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

        응답

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

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

        속성

        항목필수 여부타입설명
        startDateNoString조회시작일시 'yyyyMMdd'
        endDateNoString조회종료일시 'yyyyMMdd'
        startDateEpochNoLong조회시작일시 EpochTime
        endDateEpochNoLong조회종료일시 EpochTime
        intervalNoLong응답 데이터의 Aggregation 시간 정보
        2일 이내: 5분
        2일 초과 -일주일 이내: 30분
        일주일 초과-1개월 이내: 2시간
        1개월 초과-3개월 이내: 6시간
        bandwidthDataUnitNoString트래픽 단위 (bps)
        bandwidthDataRecordListNoList<List<Double>>트래픽 데이터 목록
        volumeDataUnitNoString전송량 단위 (byte)
        volumeDataRecordListNoList<List<Long>>전송량 데이터 목록
        requestDataUnitNoLong요청수 단위 (건수)
        requestDataRecordListNoList<List<Long>>요청수 데이터 목록
        maxBandwidthNoDouble기간 내 최대 Edge 트래픽
        totalVolumeNoLong기간 내 총 전송량
        totalRequestNoLong기간 내 총 요청수

        예시

        요청 예시

        https://ncloud.apigw.ntruss.com/cdn/v2/getCdnPlusUsageData?cdnInstanceNoList.1=1234&endDate=20220325&startDate=20220320&responseFormatType=XML
        HTTP

        응답 예시

        <?xml version="1.0" encoding="UTF-8"?>
        <getCdnPlusUsageDataResponse>
        <requestId>bfe70938-807b-4fa2-8f20-16085fd2743b</requestId>
        <returnCode>0</returnCode>
        <returnMessage>success</returnMessage>
        <startDate>20220320</startDate>
        <endDate>20220325</endDate>
        <startDateEpoch>1647702000000</startDateEpoch>
        <endDateEpoch>1648134000000</endDateEpoch>
        <interval>86400000</interval>
        <bandwidthDataUnit>bps</bandwidthDataUnit>
        <bandwidthDataRecordList>
        <list>
        <long>1647702000000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647788400000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647874800000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647961200000</long>
        <int>0</int>
        </list>
        <list>
        <long>1648047600000</long>
        <int>0</int>
        </list>
        <list>
        <long>1648134000000</long>
        <int>0</int>
        </list>
        </bandwidthDataRecordList>
        <volumeDataUnit>byte</volumeDataUnit>
        <volumeDataRecordList>
        <list>
        <long>1647702000000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647788400000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647874800000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647961200000</long>
        <int>0</int>
        </list>
        <list>
        <long>1648047600000</long>
        <int>0</int>
        </list>
        <list>
        <long>1648134000000</long>
        <int>0</int>
        </list>
        </volumeDataRecordList>
        <requestDataUnit>count</requestDataUnit>
        <requestDataRecordList>
        <list>
        <long>1647702000000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647788400000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647874800000</long>
        <int>0</int>
        </list>
        <list>
        <long>1647961200000</long>
        <int>0</int>
        </list>
        <list>
        <long>1648047600000</long>
        <int>0</int>
        </list>
        <list>
        <long>1648134000000</long>
        <int>0</int>
        </list>
        </requestDataRecordList>
        <maxBandwidth>0.0</maxBandwidth>
        <totalVolume>0</totalVolume>
        <totalRequest>0</totalRequest>
        </getCdnPlusUsageDataResponse>
        XML

        오류 코드

        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.