CDN 인스턴스 조회

Prev Next

개요

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://ncloud.apigw.gov-ntruss.com/cdn/v2/getCdnPlusInstanceList?cdnInstanceNo=711484&responseFormatType=XML

응답 예시

<?xml version="1.0" encoding="UTF-8"?>
<getCdnPlusInstanceListResponse>
  <requestId>8a19fde8-8a3b-4f61-b291-4a3f586e3c9c</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <cdnPlusInstanceList>
    <cdnPlusInstance>
      <cdnInstanceNo>711484</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>2018-03-29T21:32:18+0900</createDate>
      <lastModifiedDate>2018-12-06T21:55:25+0900</lastModifiedDate>
      <cdnInstanceDescription></cdnInstanceDescription>
      <serviceName>cdn-log-test3</serviceName>
      <isForLiveTranscoder>false</isForLiveTranscoder>
      <liveTranscoderInstanceNoList/>
      <isForImageOptimizer>false</isForImageOptimizer>
      <imageOptimizerInstanceNo></imageOptimizerInstanceNo>
      <isAvailablePartialDomainPurge>false</isAvailablePartialDomainPurge>
      <cdnPlusServiceDomainList>
        <cdnPlusServiceDomain>
          <domainId>CD000000000000008054</domainId>
          <serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
          <protocolTypeCode>HTTP</protocolTypeCode>
          <defaultDomainName>sjktsyeuckvp711484.cdn.ntruss.com</defaultDomainName>
          <userDomainName></userDomainName>
        </cdnPlusServiceDomain>
      </cdnPlusServiceDomainList>
      <cdnPlusRule>
        <protocolTypeCode>HTTP</protocolTypeCode>
        <serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
        <originUrl>ncp-cdn.origin.navercdn.com</originUrl>
        <originPath></originPath>
        <originHttpPort>80</originHttpPort>
        <originHttpsPort>0</originHttpsPort>
        <forwardHostHeaderTypeCode>REQUEST_HOST_HEADER</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>true</isReferrerDomainUse>
        <referrerDomainList>
          <string>www.naver.com</string>
          <string>*.naver.com</string>
        </referrerDomainList>
        <isReferrerDomainRestrictUse>false</isReferrerDomainRestrictUse>
        <isSecureTokenUse>false</isSecureTokenUse>
        <secureTokenPassword></secureTokenPassword>
        <isReissueSecureTokenPassword>false</isReissueSecureTokenPassword>
        <certificateName></certificateName>
        <isAccessLogUse>true</isAccessLogUse>
        <accessLogFileStorageContainerName>cdnlogtest</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.