Available in Classic and VPC
Global CDN is a NAVER Cloud Platform service that enables you to deliver content quickly and reliably from anywhere in the world through cache servers located in global locations. The Global CDN service provides APIs for instance management and monitoring features in RESTful form.
Common Global CDN settings
The following describes commonly used request and response formats in Global CDN APIs.
Request
The following describes the common request format.
API URL
The request API URL is as follows:
https://ncloud.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.
|
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
|
Accept |
Optional | Response data format
|
Response
The following describes the common response format.
Response status codes
The following describes the response status codes.
| HTTP status code | Code | Message | Description |
|---|---|---|---|
| 400 | 24109 | No such item found. If the error persists,contact Customer Service. | Non-existent request resource |
| - | 29100 | Invalid Global CDN rule format. | Invalid CDN settings format |
| - | 29101 | Can not operate this Global CDN service. Please check status. | Unable to execute the request |
| 400 | 29102 | Invalid Global CDN purge request. | Invalid purge execution request |
| - | 29103 | Invalid Global CDN service domain type code. | Invalid domain type entered |
| - | 29104 | Please enter Forward Host Header. | Missing host header forwarding setting entry |
| - | 29105 | Invalid Origin server. | Invalid source server |
| - | 29106 | Invalid Origin server ports. | Invalid source server port number |
| - | 29107 | Invalid Origin File Storage. | Invalid source storage |
| - | 29108 | Please enter Referrer Domain. | Missing referrer domain entry |
| - | 29109 | Invalid service name. | Invalid service name |
| - | 29110 | Please enter service domain. | Missing service name entry |
| - | 29111 | Invalid service domain. | Invalid service domain |
| - | 29112 | Invalid Global CDN instance. | Invalid CDN instance |
| - | 29113 | Only HTTP protocol is allowed when Origin is File Storage. | For source storage, only HTTP protocols are supported. |
| - | 29114 | This domain can not set as origin. | The domain can't be set as a source. |
| - | 29115 | For HTTPS protocol, only CDN domain can be set. | When using HTTPS protocols, only CDN domains can be set. |
| - | 29116 | An error occurred in purge request. | An error occurred while requesting the purge. |
| - | 29117 | Invalid origin path. | Invalid source path |
| - | 29118 | Invalid referrer domain. | Invalid referrer domain |
| - | 29119 | Invalid rule for access log. | Invalid access log rule |
| - | 29120 | Invalid Forward Host Header. | Invalid host header forwarding setting |
| - | 29121 | Referrer Domains can be added up to 50. | Only up to 50 referrer domains can be added. |
| - | 29122 | Can not request purge for the CDN service. Please check status. | Unable to perform purge |
| - | 29123 | The purge function can only be used after about 3 hours after the creation request is made. | Purge can't be performed for 3 hours after instance creation. |
| - | 29124 | There is an error in the service domain name entered during the purge request. | Service domain name error occurred while processing purge request. |
| 400 | 29129 | Please try your call again later. Temporarily out of service. If error continue, Please contact our customer service center. | Unable to respond due to service interruption |
Note
For information about the HTTP status codes common to all NAVER Cloud Platform, see Ncloud API response status codes.
Global CDN API
The following describes the APIs provided by the Global CDN service.
| API | Description |
|---|---|
| Get instance | Get CDN instance. |
| Get monitoring data | Get the CDN monitoring data within the query period. |
| Get usage | Get CDN usage within the query period. |
| Run purge | Run purge. |
| Get purge history | Get purge execution history. |
Global CDN related resources
NAVER Cloud Platform provides a variety of related resources to help users better understand Global CDN APIs.
- Global CDN API guides
- Create signature: How to create a signature to add to the request header
- Sub Account user guides: How to issue the access key to be added to the request header
- Common Ncloud response status codes: Information on common response status codes of NAVER Cloud Platform used by the Global Edge service
- Global Edge service guides
- Global CDN user guide: how to use Global CDN in the NAVER Cloud Platform console
- Ncloud user environment guide: Guide for VPC and Classic environments and support availability
- Pricing and features: View pricing details and key capabilities.
- Latest service news: The latest news on Global CDN
- FAQs: Get answers to common Global CDN questions.
- Contact Support: Get help if you can't find what you need in the API guide.