개요
CDN+ 인스턴스 리스트를 조회합니다.
요청
요청 파라미터
| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
|---|---|---|---|---|
| cdnInstanceNo | No | String | CDN 인스턴스 번호 | |
| pageNo | No | Integer | Min : 0, Max : 2147483647 |
건수가 많을 경우 페이지 사이즈에 해당하는 페이지 번호 |
| pageSize | No | Integer | Min : 0, Max : 2147483647 |
한 페이지에서 조회할 페이지 사이즈 |
| responseFormatType | No | String | JSON 또는 XML | 응답 타입 |
응답
모든 응답은 HTTP Status Code으로 성공/실패를 반환합니다.
| HTTP 상태 코드 | 코드 메시지 | 설명 |
|---|---|---|
| 200 | Success | 조회 성공 |
| 401 | Unauthorized | 인증 실패 |
| 500 | Internal Server Error | 서버 오류 |
속성
| 항목 | 필수 여부 | 타입 | 설명 |
|---|---|---|---|
| cdnInstanceNo | No | String | CDN 인스턴스 번호 |
| cdnInstanceStatus | No | CommonCode | CDN 인스턴스 상태 |
| cdnInstanceOperation | No | CommonCode | CDN 인스턴스 OP |
| cdnInstanceStatusName | No | String | CDN 인스턴스 상태명 |
| createDate | No | String | 생성일자 |
| lastModifiedDate | No | String | UPTIME |
| cdnInstanceDescription | No | String | CDN 인스턴스 설명 |
| serviceName | No | String | 서비스 이름 |
| isForLiveTranscoder | No | Boolean | 라이브트랜스코더 여부 |
| liveTranscoderInstanceNoList | No | List<String> | 라이브트랜스코더 인스턴스 번호 리스트 |
| isForImageOptimizer | No | Boolean | Image Optimizer 여부 |
| imageOptimizerInstanceNo | No | String | Image Optimizer 인스턴스 번호 |
| isAvailablePartialDomainPurge | No | Boolean | |
| cdnPlusServiceDomainList | No | List<CdnPlusServiceDomain> | CDN+ 서비스 도메인 리스트 |
| domainId | No | String | 도메인 ID |
| serviceDomainTypeCode | No | String | 서비스 도메인 구분코드 |
| protocolTypeCode | No | String | 프로토콜 구분코드 |
| defaultDomainName | No | String | 디폴트 도메인 이름 |
| userDomainName | No | String | 유저 도메인 이름 |
| cdnPlusRule | No | CdnPlusRule | CDN 설정 |
예시
요청 예시
https://fin-ncloud.apigw.fin-ntruss.com/cdn/v2/getCdnPlusInstanceList?cdnInstanceNo=2391364&responseFormatType=XML
응답 예시
<?xml version="1.0" encoding="UTF-8"?>
<getCdnPlusInstanceListResponse>
<requestId>7fb82c40-5072-4d56-9143-87a497cfaf33</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<cdnPlusInstanceList>
<cdnPlusInstance>
<cdnInstanceNo>2391364</cdnInstanceNo>
<cdnInstanceStatus>
<code>RUN</code>
<codeName>CDN Plus Run State</codeName>
</cdnInstanceStatus>
<cdnInstanceOperation>
<code>NULL</code>
<codeName>CDN3 NULL OP</codeName>
</cdnInstanceOperation>
<cdnInstanceStatusName>running</cdnInstanceStatusName>
<createDate>2022-06-02T16:37:34+0900</createDate>
<lastModifiedDate>2022-06-02T16:38:21+0900</lastModifiedDate>
<cdnInstanceDescription>
</cdnInstanceDescription>
<serviceName>test</serviceName>
<isForLiveTranscoder>false</isForLiveTranscoder>
<liveTranscoderInstanceNoList/>
<isForImageOptimizer>false</isForImageOptimizer>
<imageOptimizerInstanceNo>
</imageOptimizerInstanceNo>
<isAvailablePartialDomainPurge>false</isAvailablePartialDomainPurge>
<cdnPlusServiceDomainList>
<cdnPlusServiceDomain>
<domainId>CD000000000000016522</domainId>
<serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
<protocolTypeCode>HTTPS</protocolTypeCode>
<defaultDomainName>gpxwapfigdom2391364.cdn.beta.ntruss.com</defaultDomainName>
<userDomainName>
</userDomainName>
</cdnPlusServiceDomain>
</cdnPlusServiceDomainList>
<cdnPlusRule>
<protocolTypeCode>HTTPS</protocolTypeCode>
<serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
<originUrl>fin-test01.kr.beta-object.fin-ncloudstorage.com</originUrl>
<originPath>
</originPath>
<originHttpPort>80</originHttpPort>
<originHttpsPort>0</originHttpsPort>
<forwardHostHeaderTypeCode>ORIGIN_HOSTNAME</forwardHostHeaderTypeCode>
<forwardHostHeader>
</forwardHostHeader>
<cacheKeyHostNameTypeCode>REQUEST_HOST_HEADER</cacheKeyHostNameTypeCode>
<isGzipCompressionUse>true</isGzipCompressionUse>
<cachingOptionTypeCode>CACHE_CONTROL_MAX_AGE</cachingOptionTypeCode>
<isErrorContentsResponseUse>false</isErrorContentsResponseUse>
<cachingTtlTime>604800</cachingTtlTime>
<isQueryStringIgnoreUse>true</isQueryStringIgnoreUse>
<isRemoveVaryHeaderUse>true</isRemoveVaryHeaderUse>
<isLargeFileOptimizationUse>false</isLargeFileOptimizationUse>
<gzipResponseTypeCode>ORIGIN_RESPONSE</gzipResponseTypeCode>
<isReferrerDomainUse>false</isReferrerDomainUse>
<referrerDomainList/>
<isReferrerDomainRestrictUse>false</isReferrerDomainRestrictUse>
<isSecureTokenUse>false</isSecureTokenUse>
<secureTokenPassword>
</secureTokenPassword>
<isReissueSecureTokenPassword>false</isReissueSecureTokenPassword>
<certificateName>
</certificateName>
<isAccessLogUse>false</isAccessLogUse>
<accessLogFileStorageContainerName>
</accessLogFileStorageContainerName>
<isRequestCustomHeaderUse>false</isRequestCustomHeaderUse>
<requestCustomHeaderList/>
<isResponseCustomHeaderUse>false</isResponseCustomHeaderUse>
<responseCustomHeaderList/>
</cdnPlusRule>
</cdnPlusInstance>
</cdnPlusInstanceList>
</getCdnPlusInstanceListResponse>
오류 코드
| 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. |