CDN 사용량 조회
    • PDF

    CDN 사용량 조회

    • PDF

    Article Summary

    개요

    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
    

    응답 예시

    <?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>
    

    오류 코드

    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.