Global Edge overview

Prev Next

Available in Classic and VPC

Global Edge is a NAVER Cloud Platform service that sits between users and applications around the world to provide fast, reliable, and secure access to web and app content. The Global Edge service provides APIs for profile, edge, fuzzy, and certificate management features in RESTful form.

Common Global Edge settings

The following describes commonly used request and response formats in Global Edge APIs.

Request

The following describes the common request format.

API URL

The request API URL is as follows:

https://edge.apigw.ntruss.com

Request headers

The following describes the request headers.

Field Required Description
x-ncp-apigw-timestamp Required This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC.
  • Request is considered invalid if the timestamp differs from the current time by more than 5 minutes.
  • Unix timestamp format.
x-ncp-iam-access-key Required Access key issued on NAVER Cloud Platform
x-ncp-apigw-signature-v2 Required Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256)
Content-Type Optional Request data format
  • application/json
Accept Optional Response data format
  • application/json

Response

The following describes the common response format.

Response status codes

The following describes the response status codes.

HTTP status code Code Message Description
200 0000 Success Call successful
400 0040 Field validation Error Request data format mismatch
400 0101 We have a profile with the same name. Duplicated profile name
400 0102 Profiles can't be created anymore. Profile creation restriction
400 0250 An instance that is not in the Stopped status is included among the Edges you want to restart. Existence of an edge that can't perform the action
401 200 Authentication Failed Authentication failed
403 0032 Request not allowed. Unauthorized request
403 0032 The statistics query end date can't be earlier than the start date. The end date can't be earlier than the start date.
500 9999 Unknown Error Server error occurred
Note

For information about the HTTP status codes common to all NAVER Cloud Platform, see Ncloud API response status codes.

Global Edge API

This section describes the APIs provided by the Global Edge service.

Profile

The following describes the profile-related APIs.

API Description
Create profile Create profile.
Get profile list Get profile list.
Check profile name Check name validity before creating a profile.
Edit profile name Change profile name.
Delete profile Delete profile.

Edge

The following describes the edge-related APIs.

API Description
Create edge Create edge.
Get edge list Get edge list.
Get edge status Check the current status of an edge.
Get edge Get edge details.
Get edge statistics Get edge traffic statistics.
Edit edge Change edge settings.
Restart edge Restart a stopped edge.
Stop edge Stop a running edge.
Delete edge Delete a stopped edge.

Purge

The following describes the purge-related APIs.

API Description
Run purge Run purge.
Get purge history Get purge execution history.

Certificate

The following describes the certificate-related APIs.

API Description
Certificate provisioning Certificate provisioning
Get certificate list Get certificate list.
Get certificate Get certificate details.
Update certificate Update certificate.
Extend certificate application scope Add a global certificate to a Korea/Japan certificate to extend its scope.
Change TLS protocol version Change the supported TLS protocol version of a certificate.
Delete global certificate Delete an expired or expiring global certificate.
Delete certificate Delete certificate.

Global Edge related resources

NAVER Cloud Platform provides a variety of related resources to help users better understand Global Edge APIs.