CDN 모니터링 데이터 조회
- 인쇄
- PDF
CDN 모니터링 데이터 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
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. |
이 문서가 도움이 되었습니까?