CDN Purge 수행
- 인쇄
- PDF
CDN Purge 수행
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
CDN+ 퍼지를 요청합니다.
요청
요청 파라미터
| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| cdnInstanceNo | Yes | String | CDN인스턴스 번호 | |
| isWholeDomain | Yes | Boolean | true 또는 false | - 전체 도메인 여부 전체 도메인에 대한 퍼지 요청일 경우 true, 특정 도메인에 대한 퍼지 요청일 경우 false 입력 |
| domainIdList.N | No | List<String> | - 도메인 ID 리스트 특정 도메인에 대한 퍼지 요청일 경우 입력 <예시> domainIdList.1=CD000000000000016682&domainIdList.2=CD000000000000016683 | |
| isWholePurge | Yes | Boolean | true 또는 false | - 전체 퍼지 여부 전체 파일의 퍼지 요청일 경우 true, 특정 디렉토리 혹은 파일의 퍼지 요청일 경우 false 입력 |
| targetFileList.N | No | List<String> | - 대상 파일 리스트 특정 파일의 퍼지 요청일 경우 입력 <예시> targetFileList.1=alice.txt&targetFileList.2=bob.png | |
| targetDirectoryName | No | String | - 대상 디렉토리명 특정 디렉토리의 퍼지 요청일 경우 입력 해당 디렉토리 하위의 모든 파일이 퍼지됨 <예시> targetDirectoryName=/contents/sample | |
| 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 | 전체 도메인 퍼지 여부 |
| cdnPlusServiceDomainList | No | List<CdnPlusServiceDomain> | CDN+ 서비스 도메인 리스트 |
| domainId | No | String | 도메인 ID |
| serviceDomainTypeCode | No | String | 서비스 도메인 구분코드 |
| protocolTypeCode | No | String | 프로토콜 구분코드 |
| defaultDomainName | No | String | 디폴트 도메인 이름 |
| userDomainName | No | String | 유저 도메인 이름 |
| targetDirectoryName | No | String | 대상 디렉터리명 |
| targetFileList | No | List<String> | 대상 파일 리스트 |
| requestDate | No | String | 요청날짜 |
| purgeStatusName | No | String | 퍼지 상태 |
예시
요청 예시
https://ncloud.apigw.gov-ntruss.com/cdn/v2/requestCdnPlusPurge?cdnInstanceNo=711484&isWholePurge=true&isWholeDomain=true&responseFormatType=XML
응답 예시
<?xml version="1.0" encoding="UTF-8"?>
<requestCdnPlusPurgeResponse>
<requestId>337bd4f2-5bdf-4707-98f5-216c3ee79395</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<cdnPlusPurgeHistoryList>
<cdnPlusPurgeHistory>
<cdnInstanceNo>711484</cdnInstanceNo>
<purgeId>PT000000000000015497</purgeId>
<isWholePurge>true</isWholePurge>
<isWholeDomain>true</isWholeDomain>
<cdnPlusServiceDomainList>
<cdnPlusServiceDomain>
<domainId>CD000000000000008054</domainId>
<serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
<protocolTypeCode>HTTP</protocolTypeCode>
<defaultDomainName>sjktsyeuckvp711484.cdn.ntruss.com</defaultDomainName>
<userDomainName></userDomainName>
</cdnPlusServiceDomain>
</cdnPlusServiceDomainList>
<targetDirectoryName></targetDirectoryName>
<targetFileList/>
<requestDate>2018-12-09T02:00:18+0900</requestDate>
<purgeStatusName>ready</purgeStatusName>
</cdnPlusPurgeHistory>
</cdnPlusPurgeHistoryList>
</requestCdnPlusPurgeResponse>
에러 코드
| Error 코드 | 설명 |
|---|---|
| 29200 | Invalid CDN rule. |
| 29201 | Can not operate this CDN service. Please check status. |
| 29202 | Invalid CDN purge request. |
| 29203 | Invalid CDN service domain type code. |
| 29204 | Invalid CDN instance. |
| 29205 | Unable to control the CDN service because this CDN service is for Live Transcoder. |
| 29211 | An error occurred while creating CDN service. |
| 29215 | This CDN service can not request purge with partial domains. |
| 29216 | Invalid CDN service domain. |
| 29209 | The certificate can not register for CDN. |
| 29217 | Please enter target file list or directory. |
| 29218 | Please select target service domains. |
| 29221 | Unable to control the CDN service because this CDN service is for Image Optimizer. |
| 29222 | Invalid image optimizer instance number. |
| 29223 | Cache Key Hostname can not be set Origin Hostname if there is only one service domain. |
| 29224 | Cache Key Hostname can not be set Origin Hostname if use CDN domain. |
이 문서가 도움이 되었습니까?