---
title: "퍼지 수행"
slug: "networking-cdn-requestcdnpluspurge"
tags: ["CDN"]
updated: 2026-10-22T10:47:15Z
published: 2026-10-22T10:47:15Z
canonical: "api-gov.ncloud-docs.com/networking-cdn-requestcdnpluspurge"
---

> ## 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+ 퍼지를 요청합니다.

## 요청

### 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| cdnInstanceNo | Yes | String |  | CDN인스턴스 번호 |
| isWholeDomain | Yes | Boolean | true 또는 false | - 전체 도메인 여부 전체 도메인에 대한 퍼지 요청일 경우 true, 특정 도메인에 대한 퍼지 요청일 경우 false 입력 |
| domainIdList.N | No | List<String> |  | - 도메인 ID 리스트 특정 도메인에 대한 퍼지 요청일 경우 입력 <예시> domainIdList.1=CD000000000000016682&domainIdList.2=CD000000000000016683 |
| isWholePurge | Yes | Boolean | true 또는 false | - 전체 퍼지 여부 전체 파일의 퍼지 요청일 경우 true, 특정 디렉토리 혹은 파일의 퍼지 요청일 경우 false 입력 |
| targetFileList.N | No | List<String> |  | - 대상 파일 리스트 특정 파일의 퍼지 요청일 경우 입력 <예시> targetFileList.1=alice.txt&targetFileList.2=bob.png |
| targetDirectoryName | No | String |  | - 대상 디렉토리명 특정 디렉토리의 퍼지 요청일 경우 입력 해당 디렉토리 하위의 모든 파일이 퍼지됨 <예시> targetDirectoryName=/contents/sample |
| 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://ncloud.apigw.gov-ntruss.com/cdn/v2/requestCdnPlusPurge?cdnInstanceNo=711484&isWholePurge=true&isWholeDomain=true&responseFormatType=XML
```

### 응답 예시

```
<?xml version="1.0" encoding="UTF-8"?>
<requestCdnPlusPurgeResponse>
  <requestId>337bd4f2-5bdf-4707-98f5-216c3ee79395</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <cdnPlusPurgeHistoryList>
    <cdnPlusPurgeHistory>
      <cdnInstanceNo>711484</cdnInstanceNo>
      <purgeId>PT000000000000015497</purgeId>
      <isWholePurge>true</isWholePurge>
      <isWholeDomain>true</isWholeDomain>
      <cdnPlusServiceDomainList>
        <cdnPlusServiceDomain>
          <domainId>CD000000000000008054</domainId>
          <serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
          <protocolTypeCode>HTTP</protocolTypeCode>
          <defaultDomainName>sjktsyeuckvp711484.cdn.ntruss.com</defaultDomainName>
          <userDomainName></userDomainName>
        </cdnPlusServiceDomain>
      </cdnPlusServiceDomainList>
      <targetDirectoryName></targetDirectoryName>
      <targetFileList/>
      <requestDate>2018-12-09T02:00:18+0900</requestDate>
      <purgeStatusName>ready</purgeStatusName>
    </cdnPlusPurgeHistory>
  </cdnPlusPurgeHistoryList>
</requestCdnPlusPurgeResponse>
```

## 에러 코드

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