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

Prev Next

개요

CDN Purge 요청

설명

CDN 특정 인스턴스에 대하여 전체 파일, 디렉토리 단위, 개별 파일에 대한 Purge를 수행하는 API 입니다.

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
cdnInstanceNo Yes String - Purge를 수행할 대상 CDN 인스턴스 번호 입력
domainIdList No List - CDN 인스턴스 내 Purge를 수행할 도메인 리스트 입력
isWholePurge Yes Boolean - CDN 인스턴스 내 캐싱된 모든 콘텐츠를 Purge할 경우 'true' 입력
전체 퍼지를 수행할 경우 원본에 요청/트래픽이 증가로 부하가 발생할 수 있어 사용을 권고하지 않음
isWholeDomain Yes Boolean 인스턴스 정보와 일치 필요 CDN 인스턴스 내 모든 도메인에 대하여 Purge할 경우 'true'를 입력
CDN 인스턴스 정보 조회 시 'isAvailablePartialDomainPurge'의 값이 'false' 인 경우에는 'true'로만 입력해야 함
targetFileList No String Max:100개 개별 파일 단위 Purge 수행 시 대상의 파일 리스트 입력
파일은 한번에 100개까지만 수행 가능
targetDirectoryName No String - 디렉토리 Purge 수행 시 대상 디렉토리명 입력

응답 데이터 타입

  • CdnPurgeHistoryList 타입
CdnPlusPurgeHistoryList extends CommonResponse
private Integer totalRows;
private List cdnPlusPurgeHistoryList = new ArrayList();
cdnPlusPurgeHistory
private String cdnInstanceNo;
private String purgeId;
private Boolean isWholePurge;
private Boolean isWholeDomain;
private List cdnPlusServiceDomainList;
private String targetDirectoryName;
private List targetFileList;
private Date requestDate;
private String purgeStatusName;

예시

호출

ncloud cdn requestCdnPlusPurge --cdnInstanceNo 456400 --isWholePurge true --isWholeDomain true

응답

{
  "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"
      }
    ]
  }
}
<?xml version="1.0" encoding="UTF-8" ?>
<requestCdnPlusPurgeResponse>
  <requestId>927ce830-934f-42e5-9202-5b34c20b372f</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>3</totalRows>
  <cdnPlusPurgeHistoryList>
    <cdnInstanceNo>456400</cdnInstanceNo>
    <purgeId>PT000000000000001510</purgeId>
    <isWholePurge>true</isWholePurge>
    <isWholeDomain>true</isWholeDomain>
    <cdnPlusServiceDomainList>
      <domainId>CD000000000000006585</domainId>
      <serviceDomainTypeCode>USER</serviceDomainTypeCode>
      <protocolTypeCode>HTTP</protocolTypeCode>
      <defaultDomainName>bamupnqrzjwh456400.cdn.ntruss.com</defaultDomainName>
      <userDomainName>ncp-cdn.c.navercdn.com</userDomainName>
    </cdnPlusServiceDomainList>
    <targetDirectoryName></targetDirectoryName>
    <targetFileList/>
    <requestDate>2018-02-27T23:33:20+0900</requestDate>
    <purgeStatusName>ready</purgeStatusName>
  </cdnPlusPurgeHistoryList>
  <cdnPlusPurgeHistoryList>
    <cdnInstanceNo>456400</cdnInstanceNo>
    <purgeId>PT000000000000001509</purgeId>
    <isWholePurge>true</isWholePurge>
    <isWholeDomain>true</isWholeDomain>
    <cdnPlusServiceDomainList>
      <domainId>CD000000000000006581</domainId>
      <serviceDomainTypeCode>USER</serviceDomainTypeCode>
      <protocolTypeCode>HTTP</protocolTypeCode>
      <defaultDomainName>piytcmfpkjvy456400.cdn.ntruss.com</defaultDomainName>
      <userDomainName>ncp-cdn.b.navercdn.com</userDomainName>
    </cdnPlusServiceDomainList>
    <targetDirectoryName></targetDirectoryName>
    <targetFileList/>
    <requestDate>2018-02-27T23:33:20+0900</requestDate>
    <purgeStatusName>ready</purgeStatusName>
  </cdnPlusPurgeHistoryList>
  <cdnPlusPurgeHistoryList>
    <cdnInstanceNo>456400</cdnInstanceNo>
    <purgeId>PT000000000000001508</purgeId>
    <isWholePurge>true</isWholePurge>
    <isWholeDomain>true</isWholeDomain>
    <cdnPlusServiceDomainList>
      <domainId>CD000000000000006580</domainId>
      <serviceDomainTypeCode>USER</serviceDomainTypeCode>
      <protocolTypeCode>HTTP</protocolTypeCode>
      <defaultDomainName>qhytwoxdervh456400.cdn.ntruss.com</defaultDomainName>
      <userDomainName>ncp-cdn.a.navercdn.com</userDomainName>
    </cdnPlusServiceDomainList>
    <targetDirectoryName></targetDirectoryName>
    <targetFileList/>
    <requestDate>2018-02-27T23:33:20+0900</requestDate>
    <purgeStatusName>ready</purgeStatusName>
  </cdnPlusPurgeHistoryList>
</requestCdnPlusPurgeResponse>