Global CDN 개요

Prev Next

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

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

Global CDN 공통 설정

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

요청

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

API URL

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

https://ncloud.apigw.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
x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
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 응답 상태 코드를 참조해 주십시오.

Global CDN API

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

API 설명
인스턴스 조회 CDN 인스턴스 조회
모니터링 데이터 조회 조회 기간 내 CDN 모니터링 데이터 조회
사용량 조회 조회 기간 내 CDN 사용량 조회
퍼지 수행 퍼지 수행
퍼지 이력 조회 퍼지 수행 이력 조회

Global CDN 연관 리소스

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