CDN Purge 수행
- 인쇄
- PDF
CDN Purge 수행
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
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. |
이 문서가 도움이 되었습니까?