CDN Purge 수행

Prev Next

개요

Global CDN 퍼지를 요청합니다.

요청

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
cdnInstanceNo Yes String CDN인스턴스 번호
isWholeDomain Yes Boolean true 또는 false - 전체 도메인 여부
전체 도메인에 대한 퍼지 요청일 경우 true, 특정 도메인에 대한 퍼지 요청일 경우 false 입력
serviceDomainNameList.N No List<String> - 서비스 도메인명 리스트
특정 도메인에 대한 퍼지 요청일 경우 입력
<예시> serviceDomainNameList.1=sample.example.com&serviceDomainNameList.2=test.example.com
isWholePurge Yes Boolean true 또는 false - 전체 퍼지 여부
전체 파일의 퍼지 요청일 경우 true, 특정 파일의 퍼지 요청일 경우 false 입력
전체 퍼지 요청은 서비스 도메인을 지정할 수 없음
targetFileList.N No List<String> - 대상 파일 리스트
특정 파일의 퍼지 요청일 경우 입력
<예시> targetFileList.1=alice.txt&targetFileList.2=bob.png
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 전체 도메인 퍼지 여부
globalCdnServiceDomainList No List<GlobalCdnServiceDomain> Global CDN 서비스 도메인 리스트
serviceDomainTypeCode No String 서비스 도메인 구분 코드
protocolTypeCode No String 프로토콜 구분 코드
defaultDomainName No String 디폴트 도메인 이름
userDomainName No String 유저 도메인 이름
targetFileList No List<String> 대상 파일 리스트
estimatedCompletionDate No String 예상 완료 날짜
isSuccess No Boolean 성공 여부
requestDate No String 요청 날짜

예시

요청 예시

https://ncloud.apigw.gov-ntruss.com/cdn/v2/requestGlobalCdnPurge?cdnInstanceNo=697750&isWholePurge=true&isWholeDomain=true&responseFormatType=XML

응답 예시

<?xml version="1.0" encoding="UTF-8"?>
<requestGlobalCdnPurgeResponse>
  <requestId>847f09c8-54c7-4cdf-ad20-fa7608673f1d</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <globalCdnPurgeHistoryList>
    <globalCdnPurgeHistory>
      <cdnInstanceNo>697750</cdnInstanceNo>
      <purgeId>ed2b6b63-fb0b-11e8-bd53-196c5d109cd0</purgeId>
      <isWholePurge>true</isWholePurge>
      <isWholeDomain>true</isWholeDomain>
      <globalCdnServiceDomainList>
        <globalCdnServiceDomain>
          <serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
          <protocolTypeCode>HTTP</protocolTypeCode>
          <defaultDomainName>lwsitpepufak697750.gcdn.ntruss.com</defaultDomainName>
          <userDomainName></userDomainName>
        </globalCdnServiceDomain>
      </globalCdnServiceDomainList>
      <targetFileList/>
      <estimatedCompletionDate>2018-12-09T02:12:46+0900</estimatedCompletionDate>
      <isSuccess>true</isSuccess>
      <requestDate>2018-12-09T02:08:46+0900</requestDate>
    </globalCdnPurgeHistory>
  </globalCdnPurgeHistoryList>
</requestGlobalCdnPurgeResponse>

에러 코드

Error 코드 설명
29100 Invalid Global CDN rule format.
29101 Can not operate this Global CDN service. Please check status.
29102 Invalid Global CDN purge request.
29103 Invalid Global CDN service domain type code.
29104 Please enter Forward Host Header.
29105 Invalid Origin server.
29106 Invalid Origin server ports.
29107 Invalid Origin File Storage.
29108 Please enter Referrer Domain.
29109 Invalid service name.
29110 Please enter service domain.
29111 Invalid service domain.
29112 Invalid Global CDN instance.
29113 Only HTTP protocol is allowed when Origin is File Storage.
29114 This domain can not set as origin.
29115 For HTTPS protocol, only CDN domain can be set.
29116 An error occurred in purge request.
29117 Invalid origin path.
29118 Invalid referrer domain.
29119 Invalid rule for access log.
29120 Invalid Forward Host Header.
29121 Referrer Domains can be added up to 50.
29122 Can not request purge for the CDN service. Please check status.
29123 The purge function can only be used after about 3 hours after the creation request is made.
29124 There is an error in the service domain name entered during the purge request.