---
title: "인스턴스 조회"
slug: "getcdnplusinstancelist"
tags: ["CDN"]
updated: 2026-09-17T09:10:16Z
published: 2026-09-17T09:10:16Z
canonical: "api-fin.ncloud-docs.com/getcdnplusinstancelist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 인스턴스 조회

## 개요

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.ntruss.com</defaultDomainName>
            <userDomainName>
            </userDomainName>
          </cdnPlusServiceDomain>
        </cdnPlusServiceDomainList>
        <cdnPlusRule>
          <protocolTypeCode>HTTPS</protocolTypeCode>
          <serviceDomainTypeCode>DEFAULT</serviceDomainTypeCode>
          <originUrl>fin-test01.kr.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. |