---
title: "모니터링 데이터 조회"
slug: "getcdnplusmonitoringdata"
tags: ["CDN"]
updated: 2026-10-22T10:47:15Z
published: 2026-10-22T10:47:15Z
canonical: "api-gov.ncloud-docs.com/getcdnplusmonitoringdata"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 모니터링 데이터 조회

## 개요

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