Global Edge 개요

Prev Next
This content is currently unavailable in Ja - 日本語. You are viewing the default (Korean) version.

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

Global Edge는 전 세계 사용자와 애플리케이션 사이에 위치하여 웹·앱 콘텐츠를 빠르고 안정적이며 안전하게 접근하도록 돕는 네이버 클라우드 플랫폼의 서비스입니다. Global Edge 서비스에서는 프로필, 엣지, 퍼지, 인증서 관리 기능에 대한 API를 RESTful 형태로 제공합니다.

Global Edge 공통 설정

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

요청

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

API URL

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

https://edge.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 상태 코드 코드 메시지 설명
200 0000 Success 호출 성공
400 0040 Field validation Error 요청 데이터 형식 불일치
400 0101 동일한 이름의 Profile이 있습니다. 프로필 이름 중복
400 0102 더 이상 Profile을 생성할 수 없습니다. 프로필 생성 제한
400 0250 재가동하려는 Edge 중 정지 상태가 아닌 인스턴스가 포함되어 있습니다. 동작을 수행할 수 없는 엣지 존재
401 200 Authentication Failed 인증 실패
403 0032 허용되지 않은 요청입니다. 허용되지 않은 요청
403 0032 통계 조회 종료일은 시작일보다 빠를 수 없습니다. 종료일은 시작일보다 빠를 수 없음
500 9999 Unknown Error 서버 오류 발생
참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

Global Edge API

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

프로필

프로필 관련 API에 대한 설명은 다음과 같습니다.

API 설명
프로필 생성 프로필 생성
프로필 목록 조회 프로필 목록 조회
프로필 이름 체크 프로필 생성 전 이름 유효성 확인
프로필 이름 수정 프로필 이름 변경
프로필 삭제 프로필 삭제

엣지

엣지 관련 API에 대한 설명은 다음과 같습니다.

API 설명
엣지 생성 엣지 생성
엣지 목록 조회 엣지 목록 조회
엣지 상태 조회 엣지 현재 상태 조회
엣지 조회 엣지 상세 정보 조회
엣지 통계 조회 엣지 트래픽 통계 조회
엣지 수정 엣지 설정 변경
엣지 재시작 정지된 엣지 재시작
엣지 정지 운영 중인 엣지 정지
엣지 삭제 정지된 엣지 삭제

퍼지

퍼지 관련 API에 대한 설명은 다음과 같습니다.

API 설명
퍼지 수행 퍼지 수행
퍼지 이력 조회 퍼지 수행 이력 조회

인증서

인증서 관련 API에 대한 설명은 다음과 같습니다.

API 설명
인증서 프로비저닝 인증서 프로비저닝
인증서 목록 조회 인증서 목록 조회
인증서 조회 인증서 상세 정보 조회
인증서 업데이트 인증서 업데이트
인증서 적용 범위 확대 한국/일본 인증서에 글로벌 인증서를 추가하여 범위 확대
TLS 프로토콜 버전 변경 인증서의 TLS 프로토콜 지원 버전 변경
글로벌 인증서 삭제 만료되었거나 만료 예정인 글로벌 인증서 삭제
인증서 삭제 인증서 삭제

Global Edge 연관 리소스

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