To delete a CDN distribution, follow these steps:
1. In the DCD, go to Menu > Network > CDN under Edge Networking.
2. From the Distribution overview page, select the distribution you want to delete. On this page, all the CDN distributions created are listed.
3. In the Options column for the selected distribution, click and select Delete.
Result: The selected CDN distribution is successfully deleted and no longer displayed in the Distribution overview.
Once a CDN distribution is successfully created, the distribution is listed on the Distribution overview page.
To view the CDN distribution details, follow these steps:
In the DCD, go to Menu > Network > CDN under Edge Networking.
Result: A list of CDN distributions created is displayed. For every distribution listed, you can view the following details:
DOMAIN: Displays the origin domain of the distribution. Select the name to view the respective cluster details.
STATE: Displays the state of the distribution. Possible values are as follows:
Available: The distribution is available and in good condition.
Busy: When the distribution is either being updated, created, or deleted.
CREATION DATE: Displays the date of creation of the distribution.
LAST MODIFIED: Displays the date when the distribution details were last updated.
OPTIONS: Select to perform the following:
Details & Edit: You can view and edit the selected distribution details.
Copy UUID: Copy the UUID of the distribution to use this identifier in the API calls.
Copy HREF: Copy the HREF of the distribution that points to the URL provided by the CDN where the resource is hosted.
Delete distribution: Deletes the selected distribution. In the dialog box that appears, select Delete to confirm deletion. For more information, see Delete a CDN Distribution.
For the selected CDN distribution, you can view the following details:
System Information: The following system information related to the distribution is displayed:
State: Displays the state of the distribution.
UUID: The unique ID of the CDN distribution.
Resource URN: A Uniform Resource Name (URN) that uniquely identifies the resources of the distribution, which is represented as ionos:<product>:<location>:<contract>:<resource-path>.
IPv4 Address: This is the Anycast IPv4 address needed to configure the domain's Domain Name Server (DNS) settings so that the CDN functionality can be active.
IPv6 Address: This is the Anycast IPv6 address needed to configure the domain's DNS settings so that the CDN functionality can be active.
Creation date: Specifies the date and time of distribution creation.
Creation by: Unique IONOS identity specifying the user who created the distribution.
Last Modified: Specifies the date and time when the distribution was last modified.
Modified by: Unique IONOS identity specifying the user who modified the distribution.
Properties: Refers to the Domain and SSL certificate details of the distribution. For more information, see Define distribution properties.
Routing rules: Refers to the rules defined for handling the routing of content requests to this CDN distribution. For more information, see Define routing rules.
To create and manage CDN distributions via the DCD, refer to the following How-Tos.
Set required user privileges to create and manage Cloud CDN distributions.
Create a CDN distribution.
View the list of created CDN distributions.
Manage an existing CDN distribution by updating the distribution details.
Delete an existing CDN distribution.
Once a CDN distribution is successfully created, the distribution is listed on the Distribution overview page.
To update the CDN distribution details, follow these steps:
1. In the DCD, go to Menu > Network > CDN under Edge Networking.
2. In the Distribution overview, select the CDN distribution to update.
3. In the Details & Edit CDN distribution, update the distribution details needed:
Properties: Refers to the Domain and SSL certificate details of the distribution. To update these details, see .
Edit routing rule: This rule defines the rules for routing content requests to this CDN distribution. To update these details, see .
Delete routing rule: Use this option to delete an existing routing rule.
Add routing rule: You can create a routing rule. To do so, follow the steps in .
You can drag and drop the routing rules to change the precedence of the rules to apply to the CDN distribution.
4. Click Save to update the CDN distribution details with the changes made.
Result: The CDN distribution is successfully updated.
Users need appropriate privileges to create and manage CDN distributions. Cloud CDN has a new group privilege called Access and manage CDN. This privilege must be enabled for a group so that the members of this group inherit it through group privilege settings and can manage the CDN distributions.
Prerequisite: Make sure you have one or more Groups in the User Manager. To create one, see .
To set user privileges to manage CDN distributions, follow these steps:
In the DCD, go to Menu > Management > Users & Groups under Users.
Select the Groups tab in the User Manager window.
Select the appropriate group to assign relevant privileges.
In the Privileges tab, select Access and manage CDN.
Note: You can remove the privileges from the group by clearing Access and manage CDN.
Result: The privilege to manage CDN distributions is granted to all the members in the selected group.
You can revoke a user's Access and manage CDN privilege by removing the user from all the groups with this privilege enabled.
Warning: You can revoke a user from this privilege by disabling Access and manage CDN for every group the user belongs to. In this case, all the members in the respective groups would also be revoked from this privilege.
To revoke this privilege from a contract administrator, disable the administrator option on the user account. After performing this action, the contract administrator will become a contract user, and the privileges that were set up for the user before becoming an administrator will then be in effect.
A CDN distribution refers to the specific configurations that define how the content is delivered by the CDN to the users. You can create one or more CDN distributions under your contract as needed.
To create a CDN distribution, follow these steps:
Prerequisite: Make sure you have the corresponding permissions to create and manage CDN distributions. Only contract administrators, owners, and users with Access and manage CDN privilege can create a CDN distribution. For more information, see .
1. In the DCD, go to Menu > Network > CDN under Edge Networking.
2. Click Create CDN distribution from the Distribution overview page.
3. Configure the following details for a CDN distribution:
4. Click Save to apply the CDN distribution configurations.
Note:
— You can create a maximum of twenty CDN distributions, and each distribution can be configured with a maximum of twenty-five routing rules.
To define the CDN distribution properties, enter the following details:
1. Domain: Enter the origin domain, which is a URL that refers to the website address or content to access over the internet. You can use HTTP servers or Object Storage buckets as domains. For example, www.example.com.
IONOS CDN trusts and accepts SSL/TLS certificates from recognized and reputable Certificate Authorities (CAs), ensuring high security and trustworthiness. Some examples of commonly supported CAs include, but are not limited to, the following:
-- GeoTrust
-- Let's Encrypt
-- GlobalSign
Self-signed certificates are not accepted due to the security policy requirements that mandate proven certification from established authorities.
To define the routing rules for a CDN distribution, enter the following details:
1. Prefix: Enter a prefix that helps CDN determine the routing policies to apply for any URL path that begins with the prefix defined here. For example, if a prefix is defined as /docs under a routing rule, then all the URL requests that begin with /docs will be managed per the routing rules under which this prefix is defined.
2. Scheme: Choose the type of transfer protocol to allow accessing resources from HTTP/HTTPS, HTTPS, or HTTP schemes. On choosing HTTP/HTTPS, the CDN directs HTTP requests HTTP and HTTPS requests to HTTPS.
Note: Only the HTTP scheme is supported if SSL Certificate is not provided.
3. Host: Enter the upstream host URL responsible for handling content requests and serving content to the users. This host is also responsible for fetching the content from the domain if data is not already cached at the edge server. For example, server.example.com.
4. Caching: Turn on or turn off to choose whether or not to cache the responses from the upstream host. If turned on, the data responses are cached, and the user's request for the same content is served to the user next time from this cache memory.
7. (Optional) Geo Restrictions: Click Open country list to turn on or turn off the countries to be blocked or allowed, then click Save. You can also enter the alphabet in the field provided to quickly jump to the country code in the list and choose to block or allow.
8. Click Add routing rule to define another rule. Follow steps from step 1 to step 7 to add the routing rule and click Save. You can add up to twenty-five routing rules per CDN distribution.
9. When more than one routing rule exists, use the drag-and-drop option to arrange them as needed. The routing rules' precedence applies in the order in which they are ordered.
Warning: It is recommended not to set the routing rule with the Prefix value / as the first routing rule since this will override all the subsequent routing rules defined in the distribution.
Result: The CDN distribution is successfully created. An IPv4 and IPv6 Anycast IP address is provided which is needed to configure your domain's settings to activate the CDN functionality.
— If you are using IONOS , follow the steps in .
2. (Optional) SSL Certificate: Choose from the certificates already created via the Certificate Manager. You can also create a new certificate, which is then listed in the drop-down list here. To create one, follow the steps in . With a Secure Sockets Layer (SSL) certificate defined, the CDN distribution can serve content over HTTPS, the secure version of HTTP. To create auto-renewable SSL certificates based on a certificate provider like ACME, see .
5. WAF: Turn on or turn off WAF to choose whether or not to protect the upstream host from malicious threats and vulnerabilities. For more information, see . When turned on, WAF incurs additional costs.
6. Rate Limit Class: Choose from the drop-down list to limit the rate of incoming requests from specific IP addresses. The allowed rate limit class values are R1, R5, R10, R25, R50, R100, R250, and R500. For more information, see .
Configuring the DNS records for your domain completes the CDN distribution setup. For more information, see .
