---
title: "Global CDN 개요"
slug: "global-cdn-overview"
updated: 2026-10-22T10:47:15Z
published: 2026-10-22T10:47:15Z
canonical: "api-gov.ncloud-docs.com/global-cdn-overview"
---

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

# Global CDN 개요

Classic/VPC 환경에서 이용 가능합니다.

Global CDN은 전 세계 거점에 위치한 캐시 서버를 통해 세계 어느 곳에서나 빠르고 안정적으로 콘텐츠를 전송할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. Global CDN 서비스에서는 인스턴스 관리 및 모니터링 기능에 대한 API를 RESTful 형태로 제공합니다.

## Global CDN 공통 설정

Global CDN API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

### 요청

공통 요청 형식을 설명합니다.

#### API URL

요청 API URL은 다음과 같습니다.

```
https://ncloud.apigw.gov-ntruss.com
```

#### 요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

| 필드 | 필수 여부 | 설명 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초) - API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주 - Unix Timestamp 형식 |
| `x-ncp-iam-access-key` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key - Access Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi-ncpapi) 참조 - 서브 계정의 Access Key 발급 및 확인: [서브 계정 생성](https://guide.ncloud-docs.com/docs/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1) 참조 |
| `x-ncp-apigw-signature-v2` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 - Secret Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi-ncpapi) 참조 - 서명 생성: [시그니처 생성](/docs/common-ncpapi-ncpapi) 참조 |
| `Content-Type` | Optional | 요청 데이터의 형식 - `application/json` |
| `Accept` | Optional | 응답 데이터의 형식 - `application/json` |

### 응답

공통 응답 형식을 설명합니다.

#### 응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
| --- | --- | --- | --- |
| 400 | 24109 | No such item found. If the error persists,contact Customer Service. | 존재하지 않는 요청 리소스 |
| - | 29100 | Invalid Global CDN rule format. | 잘못된 CDN 설정 포맷 |
| - | 29101 | Can not operate this Global CDN service. Please check status. | 요청을 실행할 수 없는 상태 |
| 400 | 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. | 유효하지 않은 CDN 인스턴스 |
| - | 29113 | Only HTTP protocol is allowed when Origin is File Storage. | 원본 스토리지인 경우, HTTP 프로토콜만 지원 |
| - | 29114 | This domain can not set as origin. | 해당 도메인 원본 설정 불가 |
| - | 29115 | For HTTPS protocol, only CDN domain can be set. | HTTPS 프로토콜을 사용할 경우, CDN 도메인만 설정 가능 |
| - | 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. | 레퍼러 도메인은 최대 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. | 인스턴스 생성 후 3시간 동안 퍼지 수행 불가 |
| - | 29124 | There is an error in the service domain name entered during the purge request. | 퍼지 요청 처리 중 서비스 도메인 이름 오류 발생 |
| 400 | 29129 | Please try your call again later. Temporarily out of service. If error continue, Please contact our customer service center. | 서비스 일시 중단으로 응답 불가 |

              참고

              

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud API 응답 상태 코드](/docs/api-call-lgc-errorhandling)를 참조해 주십시오.

## Global CDN API

Global CDN 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [인스턴스 조회](/docs/networking-cdn-getglobalcdninstancelist) | CDN 인스턴스 조회 |
| [모니터링 데이터 조회](/docs/getglobalcdnmonitoringdata) | 조회 기간 내 CDN 모니터링 데이터 조회 |
| [사용량 조회](/docs/getglobalcdnusagedata) | 조회 기간 내 CDN 사용량 조회 |
| [퍼지 수행](/docs/networking-cdn-requestglobalcdnpurge) | 퍼지 수행 |
| [퍼지 이력 조회](/docs/networking-cdn-getglobalcdnpurgehistorylist) | 퍼지 수행 이력 조회 |

## Global CDN 연관 리소스

Global CDN API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

- Global CDN API 사용 방법
  - [서명(시그니처) 생성](/docs/common-ncpapi-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1): 요청 헤더에 추가할 서명 생성 방법
  - [Sub Account 사용 가이드](https://guide-gov.ncloud-docs.com/docs/subaccount-overview): 요청 헤더에 추가할 Access Key 발급 방법
  - [Ncloud 공통 응답 상태 코드](/docs/api-call-lgc-errorhandling): Global Edge 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Global Edge 서비스 사용 방법
  - [Global CDN 사용 가이드](https://guide-gov.ncloud-docs.com/docs/networking-networking-7-1): 네이버 클라우드 플랫폼 콘솔에서 Global CDN를 사용하는 방법
  - [Ncloud 사용 환경 가이드](https://guide-gov.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 환경 및 지원 여부에 대한 가이드
  - [요금 소개, 특징, 상세 기능](https://www.gov-ncloud.com/product/contentDelivery/globalCdn): Global CDN의 요금 체계, 특징, 상세 기능 요약
  - [서비스 최신 소식](https://www.gov-ncloud.com/intro/news?categoryCode=CTDVR&serviceCode=SV_0022): Global CDN 관련 최신 소식
  - [자주 하는 질문](https://www.gov-ncloud.com/support/faq/prod?categoryCode2=CTDVR&categoryCode3=SV_0022&page=1): Global CDN 사용자들이 자주 하는 질문
  - [문의하기](https://www.gov-ncloud.com/support/question/service): API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의