---
title: "requestCdnPlusPurge"
slug: "cli-cdn-requestcdnpluspurge"
tags: ["CDN"]
updated: 2026-10-22T09:07:19Z
published: 2026-10-22T09:07:19Z
canonical: "cli-gov.ncloud-docs.com/cli-cdn-requestcdnpluspurge"
---

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

# requestCdnPlusPurge

Classic/VPC 환경에서 이용 가능합니다.

특정 CDN+ 인스턴스에 대하여 전체 파일, 디렉토리 단위, 개별 파일에 대한 퍼지를 수행합니다.

## 구문

`requestCdnPlusPurge` 구문은 다음과 같습니다.

```
./ncloud cdn requestCdnPlusPurge \
    --cdnInstanceNo <cdn-instance-no> \
    --isWholePurge <true|false> \
    --isWholeDomain <true|false> \
    [--domainIdList <domain-id-list>] \
    [--targetDirectoryName <target-directory-name>] \
    [--targetFileList <target-file-list>] \
    [--output <json|xml>]
```

## 옵션

`requestCdnPlusPurge` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`requestCdnPlusPurge`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cdnInstanceNo` | String | Required | CDN+ 인스턴스 번호 - [getCdnPlusInstanceList](/docs/cli-cdn-getcdnplusinstancelist) 참조 |
| `--isWholePurge` | Boolean | Required | 전체 파일 퍼지 여부 - `true` \| `false` - `true`: 전체 파일 퍼지 수행. 전체 퍼지 수행 시 원본으로 요청이 증가하여 부하가 발생할 수 있음 - `false`: 특정 파일 퍼지 수행 |
| `--isWholeDomain` | Boolean | Required | 전체 도메인 퍼지 여부 - `true` \| `false` - `true`: 전체 도메인 퍼지 수행 - `false`: 특정 도메인 퍼지 수행 - CDN+ 인스턴스 정보의 `isAvailablePartialDomainPurge` 값이 `false`인 경우 `true`로만 입력. [getCdnPlusInstanceList](/docs/cli-cdn-getcdnplusinstancelist) 참조 |

### 선택 옵션

`requestCdnPlusPurge`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--domainIdList` | List | Optional | 도메인 ID 리스트 - 공백으로 구분하여 여러 개 입력 가능 (예시: `--domainIdList 1234 2345`) - `isWholeDomain`=`false`인 경우, 입력 가능 |
| `--targetDirectoryName` | String | Optional | 대상 디렉터리명 - `isWholePurge`=`false`이고, `domainIdList`가 입력된 경우, 입력 가능 - `isWholePurge`=`false`인 경우, `targetDirectoryName`, `targetFileList` 중 하나는 필수 입력 - `targetFileList`과 함께 입력할 수 없음 |
| `--targetFileList` | List | Optional | 대상 파일 리스트 - `isWholePurge`=`false`이고, `domainIdList`가 입력된 경우, 입력 가능 - `isWholePurge`=`false`인 경우, `targetDirectoryName`, `targetFileList` 중 하나는 필수 입력 - `targetDirectoryName`과 함께 입력할 수 없음 - 한 번에 100개까지만 수행 가능 |

### 공통 옵션

`cdn` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [CDN+ 옵션](/docs/cli-cdn#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

퍼지 요청이 성공하면 퍼지 이력 정보가 반환됩니다.

### 명령

명령 예시는 다음과 같습니다.

```
./ncloud cdn requestCdnPlusPurge \
    --cdnInstanceNo 456400 \
    --isWholePurge true \
    --isWholeDomain true \
    --output json
```

### 출력

출력 예시는 다음과 같습니다.

```
{
  "requestCdnPlusPurgeResponse": {
    "requestId": "927ce830-934f-42e5-9202-5b34c20b372f",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 3,
    "cdnPlusPurgeHistoryList": [
      {
        "cdnInstanceNo": "456400",
        "purgeId": "PT000000000000001510",
        "isWholePurge": true,
        "isWholeDomain": true,
        "cdnPlusServiceDomainList": [
          {
            "domainId": "CD000000000000006585",
            "serviceDomainTypeCode": "USER",
            "protocolTypeCode": "HTTP",
            "defaultDomainName": "bamupnqrzjwh456400.cdn.ntruss.com",
            "userDomainName": "ncp-cdn.c.navercdn.com"
          }
        ],
        "targetDirectoryName": "",
        "targetFileList": [],
        "requestDate": "2018-02-27T23:33:20+0900",
        "purgeStatusName": "ready"
      },
      {
        "cdnInstanceNo": "456400",
        "purgeId": "PT000000000000001509",
        "isWholePurge": true,
        "isWholeDomain": true,
        "cdnPlusServiceDomainList": [
          {
            "domainId": "CD000000000000006581",
            "serviceDomainTypeCode": "USER",
            "protocolTypeCode": "HTTP",
            "defaultDomainName": "piytcmfpkjvy456400.cdn.ntruss.com",
            "userDomainName": "ncp-cdn.b.navercdn.com"
          }
        ],
        "targetDirectoryName": "",
        "targetFileList": [],
        "requestDate": "2018-02-27T23:33:20+0900",
        "purgeStatusName": "ready"
      },
      {
        "cdnInstanceNo": "456400",
        "purgeId": "PT000000000000001508",
        "isWholePurge": true,
        "isWholeDomain": true,
        "cdnPlusServiceDomainList": [
          {
            "domainId": "CD000000000000006580",
            "serviceDomainTypeCode": "USER",
            "protocolTypeCode": "HTTP",
            "defaultDomainName": "qhytwoxdervh456400.cdn.ntruss.com",
            "userDomainName": "ncp-cdn.a.navercdn.com"
          }
        ],
        "targetDirectoryName": "",
        "targetFileList": [],
        "requestDate": "2018-02-27T23:33:20+0900",
        "purgeStatusName": "ready"
      }
    ]
  }
}
```