---
title: "퍼지 이력 조회"
slug: "getcdnpluspurgehistorylist"
tags: ["CDN"]
updated: 2026-09-17T09:10:16Z
published: 2026-09-17T09:10:16Z
canonical: "api-fin.ncloud-docs.com/getcdnpluspurgehistorylist"
---

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

# 퍼지 이력 조회

## 개요

CDN+ 퍼지 기록을 조회합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| cdnInstanceNo | Yes | String |  | CDN 인스턴스 번호 |
| purgeIdList.N | No | List<String> |  | - 퍼지 ID 리스트 특정 퍼지 ID 의 결과를 조회할 때 사용 ex) purgeIdList.1=PT000000000000002152&purgeIdList.2=PT000000000000002166 |
| responseFormatType | No | String | JSON 또는 XML | 응답 타입 |

## 응답

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

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

## 속성

| 항목 | 필수 여부 | 타입 | 설명 |
| --- | --- | --- | --- |
| cdnInstanceNo | No | String | CDN 인스턴스 번호 |
| purgeId | No | String | 퍼지 ID |
| isWholePurge | No | Boolean | 전체 퍼지 여부 |
| isWholeDomain | No | Boolean | 전체 도메인 퍼지 여부 |
| cdnPlusServiceDomainList | No | List<CdnPlusServiceDomain> | CDN+ 서비스 도메인 리스트 |
| domainId | No | String | 도메인 ID |
| serviceDomainTypeCode | No | String | 서비스 도메인 구분코드 |
| protocolTypeCode | No | String | 프로토콜 구분코드 |
| defaultDomainName | No | String | 디폴트 도메인 이름 |
| userDomainName | No | String | 유저 도메인 이름 |
| targetDirectoryName | No | String | 대상 디렉터리명 |
| targetFileList | No | List<String> | 대상 파일 리스트 |
| requestDate | No | String | 요청날짜 |
| purgeStatusName | No | String | 퍼지 상태 |

## 예시

### 요청 예시

```
https://fin-ncloud.apigw.fin-ntruss.com/cdn/v2/getCdnPlusPurgeHistoryList?cdnInstanceNo=2391364&responseFormatType=XML
```

### 응답 예시

```
<?xml version="1.0" encoding="UTF-8"?>
  <getCdnPlusPurgeHistoryListResponse>
    <requestId>57b19b16-2de0-4ac9-ab51-4372d0eb5f6f</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>3</totalRows>
    <cdnPlusPurgeHistoryList>
      <cdnPlusPurgeHistory>
        <cdnInstanceNo>2391364</cdnInstanceNo>
        <purgeId>PT000000000000002640</purgeId>
        <isWholePurge>true</isWholePurge>
        <isWholeDomain>true</isWholeDomain>
        <cdnPlusServiceDomainList>
          <cdnPlusServiceDomain>
            <domainId>CD000000000000016522</domainId>
            <serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
            <protocolTypeCode>HTTPS</protocolTypeCode>
            <defaultDomainName>gpxwapfigdom2391364.cdn.beta.ntruss.com</defaultDomainName>
            <userDomainName>
            </userDomainName>
          </cdnPlusServiceDomain>
        </cdnPlusServiceDomainList>
        <targetDirectoryName>
        </targetDirectoryName>
        <targetFileList/>
        <requestDate>2022-07-20T21:11:31+0900</requestDate>
        <purgeStatusName>success</purgeStatusName>
      </cdnPlusPurgeHistory>
      <cdnPlusPurgeHistory>
        <cdnInstanceNo>2391364</cdnInstanceNo>
        <purgeId>PT000000000000002639</purgeId>
        <isWholePurge>true</isWholePurge>
        <isWholeDomain>true</isWholeDomain>
        <cdnPlusServiceDomainList>
          <cdnPlusServiceDomain>
            <domainId>CD000000000000016522</domainId>
            <serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
            <protocolTypeCode>HTTPS</protocolTypeCode>
            <defaultDomainName>gpxwapfigdom2391364.cdn.beta.ntruss.com</defaultDomainName>
            <userDomainName>
            </userDomainName>
          </cdnPlusServiceDomain>
        </cdnPlusServiceDomainList>
        <targetDirectoryName>
        </targetDirectoryName>
        <targetFileList/>
        <requestDate>2022-07-20T21:09:45+0900</requestDate>
        <purgeStatusName>success</purgeStatusName>
      </cdnPlusPurgeHistory>
      <cdnPlusPurgeHistory>
        <cdnInstanceNo>2391364</cdnInstanceNo>
        <purgeId>PT000000000000002635</purgeId>
        <isWholePurge>false</isWholePurge>
        <isWholeDomain>true</isWholeDomain>
        <cdnPlusServiceDomainList>
          <cdnPlusServiceDomain>
            <domainId>CD000000000000016522</domainId>
            <serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
            <protocolTypeCode>HTTPS</protocolTypeCode>
            <defaultDomainName>gpxwapfigdom2391364.cdn.beta.ntruss.com</defaultDomainName>
            <userDomainName>
            </userDomainName>
          </cdnPlusServiceDomain>
        </cdnPlusServiceDomainList>
        <targetDirectoryName>
        </targetDirectoryName>
        <targetFileList>
          <string>/01.jpg</string>
          <string>/02.jpg</string>
          <string>/03.jpg</string>
        </targetFileList>
        <requestDate>2022-07-20T18:48:50+0900</requestDate>
        <purgeStatusName>success</purgeStatusName>
      </cdnPlusPurgeHistory>
    </cdnPlusPurgeHistoryList>
  </getCdnPlusPurgeHistoryListResponse>
```

## 오류 코드

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