requestCdnPlusPurge

Prev

개요

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>